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我 试图 通过 这 本 书 与 世人 分 享 我 从 黑客 变 成 软件 工程 师 的 过 程 。 本 书 主要 介绍 调试 ， 但 很 
快 你 就 会 发 现 ， 除 此 之 外 还 有 很 多 其 他 内 容 。 

感谢 你 阅读 本 书 。 
如 果 你 购买 了 本 书 ， 我 十 分 感激 。 如 有 果 你 看 的 是 免费 在 线 版 ， 我 仍然 要 感谢 你 ， 因 为 你 确 


定 这 本 书 值得 花 时 间 来 阅读 。 谁 知道 呢 ， 说 不 定 等 你 读 完 之 后 ， 会 决定 为 自己 或 朋友 买 一 
本 纸 质 书 。 


如 果 你 有 任何 评论 、 疑 问 或 建议 ,希望 你 能 写 信 告诉 我 。 你 可 以 通过 电子 邮件 直接 和 我 
联系 ， 地 址 是 obeythetestinggoat@gmail.com; 或 者 在 Twitter 上 联系 我 ， 我 的 用 户 名 是 
@hjwp。 你 还 可 以 访问 本 书 的 网 站 和 博客 (http://www.obeythetestinggoat.com/)， 以 及 邮 
件 列表 (https://groups.google.com/forum/#!forum/obey-the-testing-goat-book) 。 


望 赔 读本 书 能 让 你 身心 愉悦 ， 就 像 我 在 写作 本 书 时 感到 享受 一 样 。 


为 什么 要 写 一 本 关于 测试 驱动 开发 的 书 


我 知道 你 会 问 :“ 你 是 谁 ， 为 什么 要 写 这 本 书 ， 我 为 什么 要 读 这 本 书 ?” 


我 至 今 仍然 处 在 编程 事业 的 初期 。 人 们 说 ， 不 管 从 事 什么 工作 ， 都 要 历经 从 新 手 到 熟 手 的 

过 程 ， 最 终 有 可 能 成 为 大 师 。 我 要 说 的 是 ， 我 最 多 算是 个 熟练 的 程序 员 。 但 我 很 幸运 ， 在 
事业 的 早期 阶段 就 结识 了 一 群 测试 驱动 开发 (Test-Driven Development, TDD) 的 狂热 爱 
好 者 ， 这 对 我 的 编程 事业 产生 了 极 大 影响 ， 让 我 迫不及待 地 想 和 所 有 人 分 享 这 段 经 历 。 可 
以 说 ， 我 很 积极 地 做 出 了 最 近 这 次 转变 ， 而 且 这 上 段 学 习 经 历 现 在 还 历历 在 目 ， 我 希望 能 让 
初学 者 感同身受 。 
我 在 开始 学 习 Python 时 (看 的 是 Mark Pilgrim 写 的 Dive Into Python)， 偶 然 知道 了 TDD 的 
概念 。 我 当时 就 认为 :“ 是 的 ， 我 绝对 知道 这 个 概念 的 意义 所 在 。” 或 许 你 第 一 次 听 说 TDD 
时 也 有 类 似 的 反应 吧 。 它 听 起 来 像 是 一 个 非常 合理 的 方案 ， 一 个 需要 养 成 的 非常 好 的 习 
惯 一 一 就 像 经 常 刷牙 。 
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随后 我 做 了 第 一 个 大 型 项 目 。 你 可 能 猜 到 了 ， 有 项 目 就 会 有 客户 ， 有 最 后 期 限 ， 有 很 多 事 
情 要 做 。 于 是 ， 所 有 关于 TDD 的 好 想法 都 被 抛 诸 脑 后 。 


的 确 ， 这 对 项 目 没什么 影响 ， 对 我 也 没 影响 。 
但 只 是 在 初期 如 此 。 


一 开始 ， 我 知道 并 不 真 的 需要 使 用 TDD， 因 为 我 做 的 是 个 小 网 站 ， 手 动 检查 就 能 轻易 测试 
出 是 否 能 用 。 在 这 儿 点 击 链 接 ， 在 那儿 选中 下 拉 菜 单 选项 ， 就 应 该 有 预期 的 效果 ， 很 简单 。 
编写 整套 测试 程序 听 起 来 似乎 要 花费 很 长 时 间 ， 而 且 经 过 整整 三 周 成 熟 的 代码 编写 经 历 ， 
我 自负 地 认为 自己 已 经 成 为 一 名 出 色 的 程序 员 了 ， 我 能 顺利 完成 这 个 项 目 ， 这 没什么 难度 。 
随后 ， 项 目 变 得 复杂 得 可 怕 ， 这 很 快 暴露 了 我 的 经 验 不 足 。 

项 目 不 断 变 大 。 系 统 的 不 同 部 分 之 间 要 开始 相互 依赖 。 我 尽量 遵守 良好 的 开发 原则 ， 例 如 
“不 要 自我 重复 ”(Don't Repeat Yourself, DRY), ， 却 被 带 进 了 一 片 危险 地 带 。 我 很 快 就 用 
到 了 多 重 继承 ， 类 的 继承 有 八 个 层级 深 ， 还 用 到 了 eval 语句 。 


我 不 敢 修 改 代 码 ， 不 再 像 以 前 一 样 知道 什么 依赖 什么 ， 也 不 知道 修改 某 处 的 代码 可 能 会 
致 什么 后 果 。 噢 ， 天 呐 ， 我 觉得 那 部 分 继承 自 这 里 ， 不 ， 不 是 继承 ， 是 重新 定义 了 ， 可 是 
却 依赖 那个 类 变量 。 咽 ， 好 吧 ， 如 果 我 再 次 重 定 义 以 前 重 定义 的 部 分 ， 应 该 就 可 以 了 。 我 
会 检查 的 ， 可 是 检查 变 得 更 难 了 。 网 站 中 的 内 容 越 来 越 多 ， 手 动 点 击 变 得 不 切实 际 了 。 最 
好 别 动 这 些 能 运行 的 代码 ， 不 要 重 构 ， 就 这 么 凑合 吧 。 

很 快 ， 代 码 就 变 得 像 一 团 床 ,丑陋 不 堪 。 开 发 新 功能 变 得 很 痛苦 。 

在 此 之 后 不 入， 我 幸运 地 在 Resolver Systems 公司 (现在 叫 PythonAnywhere) 找到 了 一 份 
工作 。 这 个 公司 遵循 极限 编程 (Extreme Programming, XP) 开发 理念 。 他 们 向 我 介绍 了 
严密 的 TDD。 

虽然 之 前 的 经 验 的 确 让 我 认识 到 自动 化 测试 的 好 处 ， 但 我 在 每 个 阶段 都 心 存 疑虑 。 "我 的 
意思 是 ， 测 试 通常 来 说 可 能 是 个 不 错 的 主意 ， 但 果真 如 此 吗 ? 全 部 都 要 测试 吗 ?” 有些 测试 
看 起 来 完全 是 在 浪费 时 间 …… 什么 ? 除了 单元 测试 之 外 还 要 做 功能 测试 ? 得 了 吧 ， 这 是 多 
此 一 举 ! 还 要 走 一 遍 测 试 驱动 开发 中 的 “测试 /小 幅度 代码 改动 /测试 循环 ? Dole I 
我 们 不 需要 这 种 婴儿 学 步 般 的 过 程 ! 既然 我 们 知道 正确 的 答案 是 什么 ， 为 什么 不 直接 跳 到 
最 后 一 步 呢 ? ” 
相信 我 ! 我 审视 过 每 一 条 规则 ， 给 每 一 条 捷径 提出 过 建议 ， 为 TDD 的 每 一 个 看 似 训 无意 
义 的 做 法 寻找 过 理由 ， 最 终 ， 我 发 现 了 采用 TDD 的 明智 之 处 。 我 记 不 请 在 心里 说 过 多 少 
次 “谢谢 人 你， 测试"， 因 为 功能 测试 能 揭示 我 们 可 能 永远 都 无 法 预测 的 回归 ， 单 元 测试 能 
让 我 避免 犯 很 思春 的 逻辑 错误 。 从 心理 学 上 讲 ，TDD 大 大 降低 了 开发 过 程 中 的 压力 ， 而 且 
写 出 的 代码 让 人 赏心悦目 。 

那么 ， 让 我 告诉 你 关于 TDD 的 一 切 吧 | 


写作 本 书 的 目的 


我 写 这 本 书 的 主要 目的 是 要 传授 一 种 用 于 Web 开发 的 方法 ， 它 可 以 让 Web 应 用 变 得 更 好 ， 
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也 能 让 开发 者 更 愉快 。 一 本 书 如 果 只 包含 一 些 上 网 搜索 就 能 找到 的 知识 ， 那 它 就 没 多 大 的 
意思 了 ， 所 以 本 书 不 是 Python 句法 指南 ， 也 不 是 Web 开发 教程 。 我 希望 教会 你 的 ， 是 如 
何 使 用 TDD 理念 ， 更 加 稳妥 地 实现 我 们 共同 的 神圣 目标 一 一 简洁 可 用 的 代码 。 


即便 如 此 ， 我 仍 会 从 零 开 始 使 用 Django, Selenium, jQuery 和 Mock 等 工具 开发 一 个 Web 


应 用 ,不 断 提 到 一 个 真实 可 用 的 示例 。 阅 读本 书 之 前 ， 你 无 须 了 解 这 些 工具 。 读 完 本 书 
后 ， 


在 极限 编程 实践 中 ， 我 们 总 是 结对 编程 。 写 这 本 书 时 ， 我 设想 自己 和 以 前 的 自己 结 成 对 

















你 会 充分 了 解 这 些 工具 ， 并 掌握 TDD 理念 。 








子 ， 向 以 前 的 我 解释 如 何 使 用 这 些 工 具 ， 回 答 为 什么 要 用 这 种 特别 的 方式 编写 代码 。 所 
以 ， 如 果 我 表现 得 有 点 儿 届 苯 俯 就 ， 那 是 因为 我 不 是 那么 聪明 ， 我 要 对 自己 很 有 耐心 。 如 
果 觉 得 我 说 话 冒犯 了 你 ， 那 是 因为 我 有 点 儿 烦 人 ， 经 常 不 认同 别人 的 说 法 ， 所 以 有 时 要 花 
很 多 时 间 论 证 ， 说 服 自己 接受 他 人 的 观点 。 


本 书 结构 


我 将 这 本 书 分 成 了 三 个 部 分 。 














第 一 部 分 (第 1~7 章 ) : 基础 知识 

开门 见 山 ， 介 绍 如 何 使 用 TDD 开发 一 个 简单 的 Web 应 用 。 我 们 会 先 (用 Selenium) 5 
一 个 功能 测试 ， 然 后 介绍 Django 的 基础 知识 ， 包 括 模型 、 视 图 和 模板 。 在 每 个 阶段 ， 
我 们 都 会 编写 严格 的 单元 测试 。 除 此 之 外 ， 我 还 会 向 你 引荐 测试 山羊 。 

第 二 部 分 (第 8~17 章 ) : Web 开发 要 素 

介绍 Web 开发 过 程 中 一 些 环 手 但 不 可 避免 的 问题 ， 并 展示 如 何 通过 测试 解决 这 些 问题 ， 
包括 静态 文件 、 部 署 到 生产 环境 、 表 单数 据 验 证 、 数 据 库 迁移 和 令 人 旦 惧 的 JavaScript, 
第 三 部 分 (第 18~26 €): 高 级 话题 
介绍 模拟 技术 、 集 成 第 三 方 系统 、 测 试 固 件 、 由 外 而 内 的 TDD 流程 以 及 持续 集成 


J 
(Continuous Integration, CI), 























排版 约定 


本 书 使 用 了 下 列 排版 约定 。 


黑体 

表示 新 术语 或 强调 的 内 容 。 

等 宽 字 体 (Constant width) 

表示 程序 片段 ， 以 及 正文 中 出 现 的 变量 、 函 数 名 、 数 据 库 、 数 据 类 型 、 环 境 变 量 、 语 句 
和 关键 字 等 。 


加 粗 等 宽 字体 (Constant width bold) 
表示 应 该 由 用 户 输入 的 命令 或 其 他 文本 。 
偶尔 使 用 [...] 符号 表示 省 略 了 一 些 内 容 ， 截 断 较 长 的 输出 ， 或 者 跳 到 相关 的 内 容 。 






































该 图 标 表 示 提 示 或 建议 。 








图 标 表 示 提 示 、 建 议 或 一 般 注 记 。 


w 





图 标 表示 警告 或 警示 。 


x 





提交 勘误 


发 现 了 错误 或 错别字 ?本 书 的 相关 资源 放 在 GitHub 上 ， 欢 迎 你 随时 提交 工 单 和 拉 取 请 求 : 
https://github.com/hjwp/Book-TDD-Web-Dev-Python/。 


如 果 发 现 中 文 版 有 错误 或 错别字 ， 欢 迎 提交 勘误 至 http:/www .ituring.com.cn/book/2052。 


使 用 代码 示例 


代码 示例 可 到 https://github.com/hjwp/book-example/ 下 载 ， 各 章 的 代码 都 放 在 单独 的 分 支 
中 ， 请 到 http://www.ituring.com.cn/book/2052“ 随 书 下 载 ” 处 下 载 。 附 录 本 中 有 这 个 仓库 的 
使 用 方法 。 

本 书 是 要 帮 你 完成 工作 的 。 一 般 来 说 ， 如 果 本 书 提供 了 示例 代码 ， 你 可 以 把 它 用 在 你 的 程 
序 或 文档 中 。 除 非 你 使 用 了 很 大 一 部 分 代码 ， 否 则 无 须 联系 我 们 获得 许可 。 比 如 ， 用 本 书 
的 几 个 代码 片段 写 一 个 程序 就 无 须 获得 许可 ， 销 售 或 分 发 OReilly 图 书 的 示例 光盘 则 需要 
获得 许可 ;3 引用 本 书 中 的 示例 代码 回答 问题 无 须 获 得 许可 ， 将 书 中 大 量 的 代码 放 到 你 的 产 
品 文档 中 则 需要 获得 许可 。 

我 们 很 希望 但 并 不 强制 要 求 你 在 引用 本 书 内 容 时 加 上 引用 说 明 。 引 用 说 明 一 般 包 括 书 名 、 作 
者 、 出 版 社 和 JSBN。 比 如 : "Test-Driven Development with Python, 2nd edition, by Harry Percival 
(O’Reilly). Copyright 2017 Harry Percival, 978-1-491-95870-4." 


如 果 你 觉得 自己 对 示例 代码 的 用 法 超出 了 上 述 许可 的 范围 ， 欢 迎 你 通过 permissions @ 
oreilly.com 与 我 们 联系 。 



























































O'Reilly Safari 


。 Safari (以 前 叫 Safari Books Online, http://www.safaribookson line.com) 
d Safa [|] 是 会 员 制 平台 ， 为 企业 、 政 府 、 教 学 人 员 和 个 人 提供 培训 和 参考 


资料 。 


会 员 可 以 访问 上 千 种 图 书 、 培 训 视 频 、 学 习 路 径 、 交 互 式 教程 和 精心 制定 的 播放 列 
表 。 这 些 资源 由 250 多 家 出 版 社 提供 ， 包 括 O'Reilly Media, Harvard Business Review, 
Prentice Hall Professional, Addison-Wesley Professional, Microsoft Press, Sams, Que, 














Peachpit Press, Adobe, Focal Press, Cisco Press, John Wiley & Sons, Syngress, 
Morgan Kaufmann, IBM Redbooks, Packt, Adobe Press, FT Press, Apress, Manning, 


Ae Afr 


New Riders, McGraw-Hill, Jones & Bartlett 和 Course Technology, 44, 


详情 请 访问 httpz/oreilly.com/safari , 


联系 我 们 
请 把 对 本 书 的 评价 和 问题 发 给 出 版 社 。 
美国 : 

O'Reilly Media, Inc. 


1005 Gravenstein Highway North 
Sebastopol, CA 95472 


中 国 : 


北京 市 西城 区 西直门 南大 街 2 号 成 馈 大 厦 C 座 807 (100035) 
奥 莱 利 技术 咨询 (北京 ) 有 限 公 司 








O'Reilly 的 每 一 本 书 都 有 专属 网 页 ， 你 可 以 在 那儿 找到 本 书 的 相关 信息 ， 包 括 勘 误 表 、 





例 代码 以 及 其 他 信息 。 本 书 的 网 站 地 址 是 : 
hhttp://shop.oreilly.com/product/0636920029533.do 


对 于 本 书 的 评论 和 技术 性 问题 ， 请 发 送 电子 邮件 到 : bookquestions@oreilly.com。 
要 了 解 更 多 O'Reilly 图 书 、 培 训 课 程 、 会 议和 新 闻 的 信息 ， 请 访问 以 下 网 站 : 


http://www.oreilly.com 
我 们 在 Facebook 的 地 址 如 下 : http://facebook.com/oreilly 
请 关注 我 们 的 Twitter 动态 : http://twitter.com/oreillymedia 

















我 们 的 YouTube 视频 地 址 如 下 : http://www.youtube.com/oreillymedia 
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电子 书 


如 需 购买 本 书 












































请 扫描 以 下 二 维 

















xx | 前 言 





准备 工作 和 应 具备 的 知识 





我 假设 读者 具备 了 如 下 的 知识 ， 电 脑 中 还 应 该 安装 一 些 软件 。 


了 解 Python 3， 会 编程 


写 这 本 书 时 ， 我 考虑 到 了 初学 者 。 但 如 果 你 刚 接触 编程 ， 我 假设 你 已 经 学 习 了 Python X 
础 知识 。 如 果 还 没 学 ， 请 阅读 一 份 Python 初学 者 教程 ， 或 者 买 一 本 入 门 书 ， 比 如 Dive Into 
Python 或 《“ 策 办 法 ”学 Python》， 或 者 出 于 兴趣 ， 看 一 下 《Python 游戏 编程 快速 上 手 》。 
这 三 本 都 是 很 好 的 入 门 书 。 

如 果 你 是 经 验 丰 富 的 程序 员 ， 但 刚 接触 Python， 阅 读本 书 应 该 没 问题 。Python 简单 易 懂 。 
本 书 中 我 用 的 是 Python 3。 我 在 2013—2014 年 写 这 本 书 时 ，Python 3 已 经 发 布 好 几 年 了 ， 
全 世界 的 开发 者 正 处 在 一 个 拐点 上 ， 他 们 更 倾向 于 选择 使 用 Python 3。 可 以 参照 本 书 内 


容 在 Mac, Windows 和 Linux 中 实践 。 在 各 种 操作 系统 中 安装 Python 的 详细 说 明 后 文 会 
介绍 。 
































本 书 内 容 在 Python 3.6 中 测试 过 。 如 果 你 使 用 的 是 较 低 的 版 本 ， 可 能 会 发 
现 细微 的 差别 (比如 f 字 符 串 句法 )， 所 以 如 果 可 以 ， 最 好 升级 Python。 











我 不 建议 使 用 Python 2， 因 为 它 和 Python 3 之 间 的 区 别 太 大 。 如 果 碰 巧 你 的 下 一 个 项 目 使 用 
的 是 Python 2， 仍 然 可 以 运用 从 本 书 中 学 到 的 知识 。 不 过 ， 当 你 得 到 的 程序 输出 和 本 书 不 一 
样 时 ， 要 花 时 间 判 断 是 因为 用 了 Python 2， 还 是 因为 你 确实 犯 了 错 一 一 这 么 做 太 浪 费时 间 了 。 
如 果 你 想 使 用 PythonAnywhere (这 是 我 就 职 的 Paas 创业 公司 ) ， 不 愿 在 本 地 安装 Python， 
可 以 先 快速 阅读 一 遍 附 录 A 

无 论 如 何 ， 我 希望 你 能 使 用 Python， 知 道 如 何 从 命令 行 启 动 Python， 也 知道 如 何 编辑 和 运 
行 Python 文件 。 再 次 提醒 ， 如 果 你 有 任何 疑问 ， 看 一 下 我 前 面 推荐 的 三 本 书 。 

















XXi 


如 果 你 已 经 安装 了 Python 2， 担 心 再 安装 Python 3 会 破坏 之 前 的 版 本 ， 那 大 
可 以 放心 ，Python 3 和 Python 2 可 以 相安 无 事 地 共存 于 同一 个 系统 中 ， 使 用 
虚拟 环境 的 话 (本 书 就 是 ) 更 是 如 此 。 





HTML 的 工作 方式 


我 还 假定 你 基本 了 解 Web 的 工作 方式 ， 知 道 什 么 是 HTML、 什 么 是 POST 请 求 等 。 如 果 
你 对 这 些 概念 不 熟悉 ， 那 么 需要 找 一 份 HTML 基础 教程 看 一 下 ，webplateform 网 站 上 列 出 
了 一 些 。 如 果 你 知道 如 何在 电脑 中 创建 HTML 页 面 ， 并 在 浏览 器 中 查看 ， 也 知道 表单 以 及 
它 的 工作 方式 ， 那 么 或 许 你 就 符合 我 的 要 求 。 
































Django 


本 书 使 用 Django 框架 ， 这 或许) 是 Python 世界 最 为 人 认可 的 Web 框架 。 本 书 不 要 求 读 
者 事先 了 解 Django， 但 如 果 你 刚 接触 Python、 刚 接触 Web 开发 ， 也 刚 接触 测试 ， 偶 尔 会 
觉得 话题 太 多 ， 有 太 多 的 概念 要 理解 。 如 果 发 生 了 这 样 的 情况 ， 我 建议 你 先 把 本 书 放下 ， 
找 份 Django 教程 看 看 。DjangoGirls 是 我 所 知 的 对 新 手 最 友好 的 教程 。 官 方 教程 (https:// 
docs.djangoproject.com/en/1.11/intro/tutorial01/) 对 有 经 验 的 程序 员 来 说 是 不 错 的 选择 。 


Django 的 安装 说 明 参 见 后 文 。 






































JavaScript 


本 书后 半 部 分 有 少量 JavaScript。 如 果 你 不 了 解 JavaScript， 先 别 担心 。 如 果 你 觉得 有 些 看 
不 懂 ， 我 到 时 会 推荐 一 些 参 考 资料 给 你 。 








关于 IDE 


如 果 你 来 自 Java 或 .NET 领域 ， 可 能 非常 想 使 用 IDE (集成 开发 环境 ) 编写 Python 4X 
A, IDE 中 有 各 种 实用 的 工具 ， 例 如 VCS 集成 。Python 领域 也 有 一 些 很 棒 的 IDE。 刚 
开始 我 也 用 过 一 个 IDE， 它 对 我 最 初 的 几 个 项 目 很 有 用 。 


我 能 建议 (只 是 建议 ) 你 别 用 IDE 吗 ? 至 少 在 阅读 本 书 时 别 用 。 在 Python AU, IDE 
不 是 那么 重要 。 写 作 本 书 时 ， 我 假定 你 只 使 用 一 个 简单 的 文本 编辑 器 和 命令 行 。 某 些 
时 候 ， 它 们 是 你 所 能 使 用 的 全 部 工具 (例如 在 服务 器 中 )， 所 以 刚 开始 时 值得 花 时 间 学 
习 使 用 基本 的 工具 ,理解 它 们 是 如 何 工作 的 。 即 便当 你 读 完 本 书后 决定 继续 使 用 IDE 
和 其 中 的 实用 工具 ， 这 些 基 本 的 工具 还 是 唾 手 可 得 。 
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需要 安装 的 软件 
RT Python 之 外 ， 还 要 安装 以 下 软件 。 


Firefox Web 浏览 器 

Selenium 其 实 能 驱动 任意 一 款 主 流 浏览 器 ， 不 过 以 Firefox 举例 最 简单 ， 因 为 它 跨 平台 。 
而 且 使 用 Firefox 还 有 另外 一 个 好 处 和 公司 利益 没有 多 少 关联 。 

Git 版 本 控制 系统 

Git 可 在 任何 一 个 平台 上 使 用 。Windows 安装 环境 带 有 Bash 命令 行 ， 这 
XA Python 3, Django 1.11 和 Selenium 3 的 虚拟 环境 

Python 3.44- 现在 自 带 virtualenv 和 pip (早期 版 本 没有 ， 这 是 一 大 进步 )。 搭 建 虚拟 环境 
的 详细 说 明 参 见 后 文 。 

Geckodriver 

这 是 通过 Selenium 远程 控制 Firefox 的 驱动 。 在 “安装 Firefox 和 Geckodriver” 一 市 会 
给 出 下 载 链 接 。 
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2. Æ Git XAP, i634 i "Use Windows’default console”( 使 用 Windows 85 3k 


3. 安装 Python 3 时 ， 除 非 已 经 安装 了 Python 2 且 想 继续 将 它 用 作 上 默认 版 本 ， 否 则 一 定 


针对 Windows 的 说 明 


Windows 用 户 有 时 会 觉得 被 开源 世界 忽略 了 ， 因 为 macos fe Linux 太 普 遍 了 ， 很 容易 

让 人 忘记 在 Unix 之 外 还 有 一 个 世界 。 使 用 反 和 针线 作 为 目录 分 隔 符 ? XO 这 些 是 什 

么 ? 不 过 ， 阅 读本 书 时 仍然 可 以 在 Windows 中 实践 。 下 面 是 一 些小 提示 。 

1. 在 Windows 中 安装 Git 时 ， 一 定 要 选择 “Run Git and included Unix tools from the 
Windows command prompt" ( 在 Windows 命令 提示 符 中 运行 Git 和 所 含 的 Unix 工 
具 )， 选 择 这 个 选项 之 后 就 能 使 用 Git Bash 了 。 把 Git Bash 作为 主要 命令 提示 符 ， 
你 就 能 使 用 所 有 实用 的 GNU 命令 行 工 具 , 例如 1s、touch fe grep, EA RAH 
符 也 使 用 斜 线 表示 。 


认 控 制 台 )， 否则 Python 在 Git Bash 窗口 中 无 法 正常 使 用 。 


要 选中 “Add Python 3.6 to PATH”( 把 Python 3.6 添加 到 系统 路 径 中 ， 如 图 P-1 所 
示 )， 这 样 才 能 在 命令 行 中 顺利 运行 Python。 


测试 所 有 软件 是 否 正确 安装 的 方法 是 ， 打 开 Git Bash 命令 提示 符 ， 在 
任意 一 个 文件 夹 中 执行 命令 python 或 pip。 
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B» Python 3.6.0 (32-bit) Setup 


python 


for 


windows 


























J Install Python 3.6.0 (32-bit) 
Select Install Now to install Python with default settings, or choose 


Customize to enable or disable features. 


9 install Now 
CAUsersVEUserAppDataVLocal Programs VPythonVPython36-32 
Includes IDLE, pip and documentation 


Creates shortcuts and file associations 


— Customize installation 
Choose location and features 


Install launcher for all users (recommended) 








Cancel 








P-1: 从 安装 程序 将 Python 加 入 系统 路 径 








也 会 自动 安装 pip。 
。 Git 安装 程序 也 能 顺利 运行 。 











针对 MacOS 的 说 明 


MacOS 比 Windows 稍微 正常 一 点 儿 ， 不 过 在 Python 3.4 之前， 安装 pip 还 是 一 项 极 具 
挑战 性 的 任务 。Python 3.4 发 布 后 ， 安 装 方法 变 得 简单 明了 。 


。 使 用 下 载 的 安装 程序 就 能 安装 Python 3.6， 省 去 了 很 多 麻烦 。 而 有 全， 这 个 安装 程序 


测试 这 些 软 件 是 否 正 常安 装 的 方法 和 Windows 类 似 : 打开 一 个 终端 ， 然 后 在 任意 
位 置 执 行 命令 git, python3 或 pip。 如 果 遇 到 问题 ， 搜 索 关 键 字 “system path" je 
"command not found”， 就 能 找到 解决 问题 的 合适 资源 。 


或 许 你 还 应 该 检验 一 下 Homebrew。 在 Mac 安装 众多 Unix 工具 的 方 
式 中 ， 它 是 唯一 可 信赖 的 。' 虽然 现在 Python 安装 程序 做 得 不 错 ， 但 将 
来 你 可 能 会 用 到 Homebrew。 要 使 用 Homebrew， 需 下 载 大 小 为 1.1 GB 
的 Xcode。 不 过 这 有 个 好 处 








你 得 到 了 一 个 C 编译 器 。 





Git 默 认 使 用 的 编辑 器 和 其 他 基本 配置 


后 文 我 会 逐步 介绍 如 何 使 用 Git， 不 过 现在 最 好 做 些 配置 。 例 如 ， 首 次 提交 时 ， 默 认 情况 
下 会 弹出 vi， 这 可 能 让 你 手足 无 措 。 鉴 于 vi 有 两 种 模式 ， 因 此 你 有 两 个 选择 。 甚 一， 学 一 





注 1: 不 过 我 不 建议 使 用 Homebrew 安装 Firefox， 
位 置 ，Selenium 找 不 到 。 虽 然 这 个 问题 可 以 角 





大 

















为 Homebrew 会 把 Firefox 二 进 制 文件 放 到 一 个 陌生 的 


坚决 ， 但 是 以 常规 的 方式 安装 更 简单 。 
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些 基 本 的 vi 命令 ( 按 i 键 进入 插入 模式 ， 输 入 文本 后 再 按 <Esc> 键 返回 常规 模式 ， 然 后 输 
入 :wq<Enter> 写 入 文件 并 退出 )。 学 会 这 些 命令 后 ， 你 就 加 入 了 一 个 互助 会 ， 这 里 的 人 们 
知道 怎么 使 用 这 个 古老 而 让 人 蛇 敬 的 文本 编辑 器 。 

另外 一 个 选择 是 直接 拒绝 这 种 穿越 到 20 世纪 70 年 代 的 元 唐 行为 ， 而 是 配置 Git， 让 它 使 
用 你 选择 的 编辑 器 。 按 <Esc> 键 ， 再 输入 :9!， 退 出 vi， 然 后 修改 Git 使 用 的 默认 编辑 器 。 
有 具体 方法 参见 介绍 Git 基本 配置 的 文档 。 

















安装 Firefox 和 Geckodriver 


从 https://www.mozilla.org/firefox/ 可 下 载 Windows 和 macOS 的 Firefox 安装 包 。Linux 可 能 
已 经 预 装 了 Firefox; 如 果 没 有 ， 使 用 包 管 理 器 安装 。 

Geckodriver 可 从 https://github.com/mozilla/geckodriver/releases 下 载 。 下 载 后 解压 ， 放 到 系 
统 路 径 中 的 某 个 位 置 。 

e Xf macOS x Linux 来 说 ， 可 以 放 在 ~/.local/bin 目录 中 。 

。 对 Windows 来 说 ， 可 以 放 在 Python 的 Scripts 文件 夹 中 。 

为 了 确认 是 否 成 功 安装 ， 打 开 一 个 Bash 控制 台 ， 执 行 下 述 命令 : 


geckodriver --version 
geckodriver 0.17.0 














The source code of this program is available at 
https://github.com/mozilla/geckodriver. 


This program is subject to the terms of the Mozilla Public License 2.0. 
You can obtain a copy of the license at https://mozilla.org/MPL/2.0/. 


如 果 无 法 执行 这 个 命令 ， 可 能 是 因为 ~/.local/bin 不 在 PATH 中 (针对 Mac 和 Linux 系统 )。 
这 个 文件 夹 最 好 加 到 PATH 中 ， 因 为 使 用 pip install --user 安装 的 Python 包 都 存储 在 这 
里 。 把 这 个 文件 夹 添 加 到 .bashrc 文件 中 的 方法 如 下 所 示 “: 


echo 'PATH=~/ .LocaL/bin:SPATH' >> ~/ .bashrc 


然后 关闭 终端 ， 重 新 打开 ， 再 次 确认 能 否 执行 geckodriver --version 命令 。 


搭建 虚拟 环境 


Python 项 目 所 需 的 环境 使 用 virtualenv (virtual environment 的 简称 ) 搭建 。 在 不 同 项 目的 
虚拟 环境 中 可 以 使 用 不 同 的 包 (例如 不 同 版 本 的 Django， 甚 至 是 不 同 版 本 的 Python). ifi 
且 虚 拟 环境 中 的 包 不 是 全 局 安装 的 ， 因 此 无 须 root 权限 。 


Python 从 3.4 版 开始 集成 了 用 于 搭建 虚拟 环境 的 virtualenv 工具 ， 不 过 我 始终 建议 使 用 
virtualenvwrapper 这 个 辅助 工具 。 先 安装 virtualenvwrapper (对 Python 版 本 没有 要 求 ) : 





























注 2: .bashrc 是 Bash 的 初始 化 文件 ， 在 家 目录 中 。 每 次 运行 Bash 都 会 运行 这 个 文件 。 
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# 在 Windows 中 

pip install virtualenvwrapper 

# 在 mac0S/Linux 中 

pip install --user virtualenvwrapper 

# 然后 让 Bash 自 动 加 载 virtualenvwrapper 

echo "source virtualenvwrapper.sh" >> ~/.bashrc 
source -/.bashrc 








在 Windows rP, virtualenvwrapper 只 能 在 Git Bash 中 使 用 ， 而 不 能 在 常 
规 的 命令 行 中 使 用 。 


























virtualenvwrapper 把 所 有 虚拟 环境 都 放 在 一 个 地 方 ， 而 且 为 激活 和 停 用 虚拟 环境 提供 了 便 
利 的 工具 。 


下 面 创建 一 个 名 为 “superlists” 的 虚拟 环境 , 并 在 里 面 安 装 Python 3: 


# 在 mac0S/Linux 中 

mkvirtualenv --python=python3.6 superlists 

# 在 Windows 中 

mkvirtualenv --python-'py -3.6 -c"import sys; print(sys.executable)"" superlists 


# (为 了 得 到 一 个 装 有 Python 3.6 的 虚拟 环境 ， 我 们 绕 了 点 弯 子 ) 


激活 和 停 用 虚拟 环境 
阅读 本 书 时 ， 一 定 要 先 “ 激 活 ” 你 的 虚拟 环境 。 你 之 所 以 能 看 出 我 们 处 在 虚拟 环境 中 ， 
向 是 因为 提示 符 中 有 (superLists) ， 例 如 ; 

$ 

(superlists) $ 


创建 虚拟 环境 之 后 ， 就 直接 激活 了 虚拟 环境 。 你 可 以 执行 which python 命令 再 次 确认 : 


(superlists) $ which python 

/home/harry/.virtualenvs/superlists/bin/python 
# (在 Windows 中 会 显示 为 下 面 这 样 
# /C/Users/IEUser/.virtualenvs/superlists/Scripts/python) 























(superlists) $ deactivate 
$ which python 
/usr/bin/python 

$ python --version 


Python 2.7.12 # 在 我 的 设备 中 ， 虚 拟 环境 外 部 的 “python” 默 认为 Python 2 


$ workon superlists 

(superlists) $ which python 
/home/harry/.virtualenvs/superlists/bin/python 
(superlists) $ python --version 

Python 3.6.0 





注 3; 你 可 能 会 问 为 什么 叫 “superlists”? 我 可 不 想 剧 透 ! 下 一 章 你 就 知道 了 
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激活 虚拟 环境 的 命令 是 workon superLists。 若 想 确 认 有 没有 激活 ， 可 以 
命令 提示 符 中 有 没有 (superlists) 5， 或 者 执行 which python 命令 。 














安装 Django 和 Selenium 
我 们 将 安装 Django 1.11 和 最 新 版 Selenium， 即 Selenium 3; 


(superlists) $ pip install "django«1.12" "selenium<4" 
Collecting django--1.11.3 

Using cached Django-1.11.3-py2.py3-none-any.whl 
Collecting selenium«4 

Using cached selenium-3.4.3-py2.py3-none-any.whl 
Installing collected packages: django, selenium 
Successfully installed django-1.11.3 selenium-3.4.3 


无 法 激活 虚拟 环境 时 可 能 会 看 到 的 一 些 错误 消息 
对 刚 接触 虚拟 环境 的 人 来 说 ， 肯 定 会 经 常 忘记 激活 虚拟 环境 〈 说 实话 ， 老 手 也 经 常 犯 这 个 
错 ， 比 如 我 )。 这 时 ， 你 会 看 到 一 个 错误 消息 ， 其 中 的 重要 部 分 如 下 所 示 : 

ImportError: No module named selenium 
或 者 是: 

ImportError: No module named django.core.management 
如 果 遇 到 这 种 错误 ， 不 要 慌 ， 先 看 看 命令 提示 符 中 有 没有 (superLists)。 通 常 只 需 执行 
workon superLists 就 能 解决 问题 。 
除 此 之 外 ， 可 能 还 会 遇 到 这 个 错误 : 

bash: workon: Command not found 
这 表明 你 前 面 少 做 了 一 步 ， 疫 有 把 virtualenvwrapper 添加 到 .bashrc 中 。 从 前 文中 找到 
echo source virtualenvwrapper.sh 命令 ， 再 执行 一 遍 。 


'workon' is not recognized as an internal or external command, 
operable program or batch file. 


这 表明 你 打开 的 是 Windows 的 默认 命令 提示 符 cnd， 而 不 是 Git Bash。 关 掉 cmd, FTIF 
Git Bash, 


编程 快乐 ! 


上 述说 明 对 你 没什么 用 ， 或 者 你 有 更 好 的 说 明 ? 请 给 我 发 电子 邮件 吧 ， 地 址 


是 obeythetestinggoat@ gmail.com, 
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配套 视频 


我 为 本 书 录制 了 一 套 十 集 的 配套 视频 (http://oreil.ly/1svTFqB) ', 主 要 针对 第 一 部 分 的 内 容 。 
如 果 你 更 适合 通过 视频 学 习 ， 建 议 你 看 看 。 除 了 书 中 的 内 容 之 外 ， 这 套 视 频 还 能 让 你 直观 
地 感受 TDD 流程 ， 了 解 如 何在 测试 和 代码 之 间 切 换 ， 与 此 同时 保持 思路 清晰 。 


我 还 特意 穿 了 一 件 亮 黄 色 了 T 恤 。 











Unittest (Free) 














注 1: 这 套 视 频 没 有 针对 第 2 版 更 新 ， 不 过 内 容 基 本 上 依然 适用 。 
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第 一 部 分 
TDD 和 Django 基 础 





第 一 部 分 我 要 介绍 测试 驱动 开发 (Test-Driven Development, TOD) 的 基础 知识 。 我 们 会 
从 零 开 始 开发 一 个 真实 的 Web 应 用 ， 而 且 每 个 阶段 都 要 先 写 测试 。 

这 一 部 分 涵盖 使 用 Selenium 完成 的 功能 测试 以 及 单元 测试 ， 还 会 介绍 二 者 之 间 的 区 别 。 我 
会 介绍 TDD 流程 ， 我 称 之 为 “单元 测试 /编写 代码 ”循环 。 我 们 还 要 做 些 重 构 ， 说 明 怎么 
结合 TDD 使 用 。 因 为 版 本 控制 对 重要 的 软件 工程 来 说 是 基本 需求 ， 所 以 我 们 还 会 用 到 版 
本 控制 系统 (Git)。 我 会 介绍 何 时 以 及 如 何 提交 ， 如 何 把 提交 集成 到 TDD 和 Web 开发 的 
流程 中 。 

我 们 要 使 用 Django， 它 (或许) 是 Python 领域 之 中 最 受 欢 迎 的 Web 框架 。 我 会 试 着 慢 慢 
介绍 Django 的 概念 ， 一 次 一 个 ， 除 此 之 外 还 会 提供 很 多 扩展 阅读 资料 的 链接 。 如 果 你 完 
全 是 刚 接触 Django， 那 么 我 极力 推荐 你 花 时 间 阅 读 这 些 资料 。 如 果 你 感觉 有 点 儿 茫 然 ， 花 
儿 小 时 读 一 遍 Django 的 官方 教程 ， 然 后 再 回来 呵 读本 书 。 


你 还 会 结识 测试 山羊 …… 














复制 粘贴 时 要 小 心 


如 果 你 看 的 是 电子 版 ， 那 么 在 阅读 的 过 程 之 中 就 会 很 自然 地 会 想 要 复制 粘贴 
书 中 的 代码 清单 。 如 果 不 这 么 做 的 话 效果 会 更 好 : 动手 输入 能 形成 肌肉 记 
TL, 感觉 也 更 真实 。 你 偶尔 会 打 错 字 ， 这 是 无 法 避免 的 ， 调 试 错 误 也 是 一 项 
需要 学 习 的 重要 技能 。 


除 此 之 外 ， 你 还 会 发 现 PDF 格式 相当 诡异 ， 复 制 粘贴 时 经 常会 有 意 想不到 的 
事情 发 生 E 
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TDD 不 是 天 生 就 会 的 技术 ， 而 是 像 武术 一 样 的 一 种 技能 。 就 像 在 功夫 电影 中 一 样 ， 你 需要 
一 个 脾气 不 好 、 不 可 理喻 的 师傅 来 强制 你 学 习 。 我 们 的 师傅 是 测试 山羊 。 


1.1 遵从 测试 山羊 的 教诲 ， 没 有 测试 什么 也 别 做 
在 Python 测试 社区 中 ， 测 试 山羊 是 TDD 的 非 官方 吉祥 物 。 测 试 山 羊 对 不 同 的 人 有 不 同 的 
意义 。 对 我 来 说 ， 它 是 我 脑海 中 的 一 个 声音 ， 告 诉 我 要 一 直 走 在 测试 这 条 正确 的 道路 上 ， 
就 像 卡 通 片 中 浮现 在 肩膀 上 的 天 使 或 魔鬼 一 样 ， 只 是 没 那 么 吊 员 逼 人 。 我 希望 借 由 这 本 
书 ， 让 测试 山羊 也 扎根 于 你 的 脑海 中 。 

虽然 还 不 太 确 定 要 做 什么 ， 但 我 们 已 经 决定 要 开发 一 个 网 站 。Web 开发 的 第 一 步 通常 是 
安装 和 配置 Web 框架 。 下 载 这 个 ， 安 装 那个 ， 配 置 那个 ， 运 行 这 个 脚本 …… 但 是 ， 使 用 
TDD 时 要 转换 思维 方式 。 做 测试 驱动 开发 时 ， 你 的 心里 要 一 直 记 着 测试 山羊 ， 像 山羊 一 样 
dep, GEER: "Jesu, EAR” 

在 TDD 的 过 程 中 ， 第 一 步 始终 一 样 : 编写 测试 。 

首先 要 编写 测试 ， 然 后 运行 ， 看 是 否 和 预期 一 样 失败 ， 只 有 失败 了 才能 继续 下 一 步 
写 应 用 程序 。 请 模仿 山羊 的 声调 复述 这 个 过 程 。 我 就 是 这 么 做 的 。 

山羊 的 另 一 个 特点 是 一 次 只 迈 一 步 。 因 此 ， 不 管 山 壁 多 么 陡峭 ， 它 们 都 不 会 跌落 。 看 看 
图 1-1 里 的 这 只 山羊 ! 














编 




















图 1-1: 山羊 比 你 想象 的 要 机 敏 GEB: Flickr 用 户 Caitlin Stewart) 


我 们 会 碎 步 向 前 。 使 用 流行 的 Python Web 框架 Django 开发 这 个 应 用 。 
首先 ， 要 检查 是 否 安装 了 Django， 并 且 能 够 正常 运行 。 检 查 的 方法 是 ， 在 本 地 电脑 中 能 
否 启动 Django 的 开发 服务 器 ， 并 在 浏览 器 中 查看 能 否 打 开 网 页 。 使 用 浏览 器 自动 化 工具 








Selenium 完成 这 个 任务 。 








在 你 想 保存 项 目 代 码 的 地 方 新 建 一 个 Python 文件 ， 命 名 为 functional_tests.py， 并 输入 以 下 


代码 。 如 果 你 喜欢 一 边 输 入 代码 一 边 像 山羊 那样 轻声 念 四 ， 或 许 会 有 所 帮助 : 


from selenium import webdriver 


browser = webdriver.Firefox() 
browser.get('http://localhost:8000') 


assert 'Django' in browser.title 


functional tests.py 





这 是 我 们 编写 的 第 一 个 功能 测试 (Functional Test, FT), Jat 








i 我 会 深入 说 明 什么 是 功能 测 





试 ， 以 及 它 和 单元 测试 的 区 别 。 现 在 ， 只 要 能 理解 这 段 代码 做 了 什么 就 行 。 
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° 局 动 一 个 Selenium webdriver， 打 开 一 个 真正 的 Firefox 浏览 器 窗口 。 
。 在 这 个 浏览 器 中 打开 我 们 期 望 本 地 电脑 伺服 的 网 页 。 
. ie euis e 这 个 网 页 的 标题 中 是 否 包含 单词 “Django 。 
我 们 尝试 运行 一 下 : 
$ python functional tests.py 
File ".../selenium/webdriver/remote/webdriver.py", line 268, in get 
self.execute(Command.GET, ('url': url}) 
File ".../selenium/webdriver/remote/webdriver.py", line 256, in execute 
self.error handler.check response(response) 
File ".../selenium/webdriver/remote/errorhandler.py", line 194, in 
check response 
raise exception class(message, screen, stacktrace) 


selenium.common.exceptions.WebDriverException: Message: Reached error page: abo 
ut:neterror?e-connectionFailure&u-http*3A//localhost?:3348000/[...] 


尔 应 该 会 看 到 弹出 了 一 个 浏览 器 窗口 ， 堂 试 打开 localhost:8000， 然 后 显示 “无 法 连接 ” 错 
误 页 面 。 这 时 回 到 终端 ， 你 会 看 到 一 个 显眼 的 错误 消息 息 ， 说 Selenium 遇 到 了 一 个 错误 页 
Mo ZE, MAAF Firefox 窗口 停留 在 桌面 上 ， 等 待 你 关闭 。 这 可 能 会 让 你 生气 ， 我 们 
稍 后 会 修正 这 个 问题 。 























LI 


如 果 看 到 关于 导入 Selenium 的 错误 ， 或 者 让 你 查找 “geckodriver” 错 误 ， 或 
许 你 应 该 往 前 翻 ， 看 一 下 “准备 工作 和 应 具备 的 知识 ”。 











现在 ， 得 到 了 一 个 失败 测试 。 这 意味 着 ， 我 们 可 以 开始 开发 应 用 了 。 





别 了 ， 罗 马 数 字 
很 多 介绍 TDD 的 文章 都 喜欢 以 罗马 数字 为 例 ， 阅 了 笑话 ， 甚 至 我 一 开始 也 是 这 么 写 
的 。 如 果 你 好 奇 ， 可 以 查看 我 在 GitHub 的 页 面 ， 地 址 是 https://github.com/hjwp/。 
以 罗马 数字 为 例 有 好 也 有 坏 。 把 问题 简化 ， 合 理 地 限制 在 某 一 范围 内 ， 让 你 能 很 好 地 
解说 TDD。 
但 问题 是 不 切实 际 。 因 此 我 才 决 定 要 从 零 开 始 开发 一 个 真实 的 Web 应 用 ， 以 此 为 例 介 
绍 TDD。 这 是 一 个 简单 的 Web 应 用 ， 我 希望 你 能 把 从 中 学 到 的 知识 运用 到 下 一 个 真 
实 的 项 目 中 。 











1.2 ”让 Dijango 运 行 起 来 


你 肯定 已 经 读 过 了 ， 也 安装 了 Djngo, fH] Django 的 第 一 
步 是 创建 项 目 ， 我 们 的 网 站 就 放 在 这 个 项 目 中 。Django 为 此 提供 了 一 个 命令 行 工 具 : 


$ django-admin.py startproject superlists 
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这 个 命令 会 创建 一 个 名 为 superlists 的 文件 夹 ， 并 在 其 中 创建 一 些 文件 和 子 文件 夹 ; 


一 functionaL_tests.py 
一 geckodriver .Log 
L— superlists 


HF manage.py 
L— superlists 


— | init .py 

FF settings.py 

I— urls.py 

L— wsgi.py 
在 superlists 文件 夹 中 还 有 一 个 名 为 superlists 的 文件 夹 。 这 有 点 让 人 困惑 ， 不 过 确实 
需要 如 此 。 回 顾 Django 的 历史 ， 你 会 找到 出 现 这 种 结构 的 原因 。 现 在 ， 重 要 的 是 知道 
superlists/superlists 文件 夹 的 作用 是 保存 应 用 于 整个 项 目的 文件 ， 例 如 settings.py 的 作用 是 
存储 网 站 的 全 局 配置 信息 。 
你 还 会 注意 到 manage.py。 这 个 文件 是 Django 的 瑞士 军刀 ， 作 用 之 一 是 运行 开发 服务 器 。 
我 们 来 试 一 下 。 执 行 命令 cd supertlists， 进 入 顶层 文件 夹 superlists (我 们 会 经 常 在 这 个 
文件 夹 中 工作 )， 然 后 执行 : 


$ python manage.py runserver 
Performing system checks... 











System check identified no issues (0 silenced). 


You have 13 unapplied migration(s). Your project may not work properly until 
you apply the migrations for app(s): admin, auth, contenttypes, sessions. 
Run 'python manage.py migrate' to apply them. 


Django version 1.11.3, using settings 'superlists.settings' 


Starting development server at http://127.0.0.1:8000/ 
Quit the server with CONTROL-C. 


暂时 先 不 管 关 于 “未 应 用 迁移 ”的 消息 ， 第 5 章 将 讨论 迁移 。 





这 样 ，Django 的 开发 服务 器 便 在 设备 中 运行 起 来 了 。 让 这 个 命令 一 直 运行 着 ， 再 打开 一 个 
命令 行 窗口 (进入 刚刚 打开 的 文件 夹 )， 在 其 中 再 次 运行 测试 : 


$ python functional tests.py 
$ 


因为 打开 了 新 的 终端 窗口 ， 所 以 要 先 执行 workon superlists 命令 激活 虚拟 
环境 。 
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我 们 在 命令 行 中 没 执行 多 少 操作 ， 但 你 应 该 注意 两 件 事 : 第 一 ， 没 有 丑陋 的 AssertionError 
T; Æ, Selenium 弹出 的 Firefox 窗口 中 显示 的 页 面 不 一 样 了 。 


这 虽然 看 起 来 设 什 么 大 不 了 ， 但 毕竟 是 我 们 第 一 个 通过 的 测试 啊 ! 值得 庆祝 。 


如 果 感 沉 有 点 神奇 ， 不 太 现实 ， 为 什么 不 手动 查看 开发 服务 器 ， 打 开 训 览 绒 访问 http:/ 
localhost:8000 呢 ? 你 会 看 到 如 图 1-2 所 示 的 页 面 。 



































|^ Welcome to Django - Mozilla Firefox * 
|File Edit View History Bookmarks Tools Help 
| £3 welcome to Django | zu] 

@ localhost:800 v Q | | 图 Google Q 业 合 Xr 


It worked! 
Congratulations on your first Django-powered page. 


Of course, you haven't actually done any work yet. Next, start your first app by running 
python manage.py startapp [appname]. 


You're seeing this message because you have esw = True in your Django settings file and 
you haven't configured any URLs. Get to work! 


O- x 8 ® 




















1-2; Django 可 用 了 








如 果 想 退出 开发 服务 器 ， 可 以 回 到 第 一 个 shell 中 ， 按 Ctrl-C 键 。 


1.3 ”创建 Git 仓 库 


结束 这 章 之 前 ， 还 要 做 一 件 事 : 把 作品 提交 到 版 本 控制 系统 (Version Control System, 
VCS)。 如 果 你 是 一 名 经 验 丰富 的 程序 员 ， 就 无 须 再 听 我 宣讲 版 本 控制 了 。 如 果 你 刚 接触 
VCS， 请 相信 我 ， 它 是 必 备 工具 。 当 项 目 在 几 周 内 无 法 完成 ， 代 码 越 来 越 多 时 ， 你 需要 一 
个 工具 查看 旧版 代码 、 撤 销 改 动 、 放 心地 试验 新 想法 ， 或 者 只 是 做 个 备份 。 测 试 驱动 开发 
和 版 本 控制 关系 紧密 ， 所 以 我 一 定 要 告诉 你 如 何在 开发 流程 中 使 用 版 本 控制 系统 。 


好 的 ， 来 做 第 一 次 提交 。 如 果 现 在 提交 已 经 晚 了 ， 我 表示 火 意 。 我 们 使 用 Git 作为 VCS, 
因为 它 是 最 棒 的 。 
我 们 先 把 functional tests.py 移 到 superlists 文件 夹 中 。 然 后 执行 git init 命令 ， 创 建仓 库 : 
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$ ls 


superlists functional_tests.py geckodriver .Log 
$ mv functional_tests.py superlists/ 


$ cd superlists 
$ git init . 


Initialised empty Git repository in /.../superlists/.git/ 





自 此 工作 目录 都 是 顶层 superlists 文件 夹 


从 现在 起 ， 我们 会 把 顶层 文件 夹 superlists 作为 工作 目录 。 
(简单 起 见 ， 我 在 命令 列表 中 都 将 使 用 /.../superlists/ 表示 这 个 目录 。 但 实际 上 ， 这 个 目 
录 的 真实 地 址 可 能 是 /home/kind-reader-username/my-python-projects/superlists/., ) 


我 提供 的 输入 命令 部 假定 在 这 个 目录 中 执行 。 同 样 ， 如 果 我 提 到 一 个 文件 的 路 径 ， 也 
是 相对 于 这 个 顶层 目录 而 言 。 因 此 ，superlists/settings.py 是 指 次 级 文件 夹 superlists 中 


的 settings.py。 


理解 了 吗 ? 如果 有 和 疑问， 就 查找 manage.py， 你 要 和 这 个 文件 在 同一 个 目录 中 。 








现在 ， 看 一 下 要 提交 的 文件 : 


$ ls 


db.sqlite3 manage.py  superlists functional tests.py 


db.sglite3 是 数据 库 文 件 ， 无 须 纳 入 版 本 控制 。 前 面 见 过 的 geckodriver.log 是 Selenium 的 日 
志文 件 ， 也 无 须 跟踪 变化 。 我 们 要 把 这 两 个 文件 添加 到 一 个 特殊 的 文件 .gitignore 中 ， 让 


Git 忽略 它们 : 





$ echo "db.sqlite3" >> .gitignore 
$ echo "geckodriver.log" >> .gitignore 


接 下 来 ,我们 可 以 添加 当前 文件 夹 (“.”) 中 的 其 他 内 容 了 : 


$ git add . 
$ git status 
On branch master 


Initial commit 

















Changes to be committed: 


(use "git rm --cached «files... 


new file: 
new file: 
new file: 
new file: 
new file: 
new file: 
new file: 
new file: 
new file: 


to unstage) 


.gitignore 

functional tests.py 

manage.py 

superlists/ init .py 

superlists/ pycache / init .cpython-36.pyc 
superlists/  pycache /settings.cpython-36.pyc 
superlists/  pycache /urls.cpython-36.pyc 
superlists/  pycache /wsgi.cpython-36.pyc 
superlists/settings.py 
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new file: | superlists/urls.py 
new file: | superlists/wsgi.py 


糟糕 ， 添 加 了 很 多 pyc 文件 ， 这 些 文件 没 必 要 提交 。 将 其 从 Git 中 删 掉 ， 并 添加 到 .gitignore 中 


$ git rm -r --cached superlists/. pycache . 

rm 'superlists/ pycache / init .cpython-36.pyc' 
rm 'superlists/  pycache /settings.cpython-36.pyc' 
rm 'superlists/ pycache /urls.cpython-36.pyc' 

rm 'superlists/ pycache /wsgi.cpython-36.pyc' 

$ echo " pycache " »» .gitignore 

$ echo "*.pyc" »» .gitignore 


现在 ， 来 看 一 下 进展 到 哪里 了 。( 你 会 看 到 ， 我 使 用 git status 的 次 数 太 多 了 ， 所 以 经 党 
会 使 用 别名 git st。 我 不 会 告诉 你 怎么 做 ， 你 要 自己 探索 Git 别名 的 秘密 ! ) 








$ git status 
On branch master 


Initial commit 


Changes to be committed: 
(use "git rm --cached <file>... 


to unstage) 


new file: .gitignore 

new file: | functional tests.py 
new file: manage.py 

new file: | superlists/ init .py 
new file: superlists/settings.py 
new file: | superlists/urls.py 

new file: | superlists/wsgi.py 


Changes not staged for commit: 
(use "git add <file>..." to update what will be committed) 
(use "git checkout -- <file>..." to discard changes in working directory) 


modified: .gitignore 


看 起 来 不 错 ， 可 以 做 第 一 次 提交 了 : 


$ git add .gitignore 
$ git commit 








输入 git commit 后 ， 会 弹出 一 个 编辑 器 窗口 ， 让 你 输入 提交 消息 。 我 写 的 消息 如 图 1-3 
Bm. 











: 是 不 是 vi 弹出 后 你 不 知道 该 做 什么 ? 或 者 ， 你 是 不 是 看 到 了 一 个 消息 ， 内 容 是 关于 账户 识别 的 

















， 其 中 
还 显示 了 git config --global user.username ? 再 次 看 一 下 “准备 工作 和 应 具备 的 知识 ”, 里 面 有 一 些 
简单 说 明 。 
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COMMIT. EDITMSG + (/workspace/superlists/.git) - VIM 


x 


File Edit View Search Terminal Help 
First commit: First FT and basic Django config 

# Please enter the commit message for your changes. Lines starting 
# with '£' will be ignored, and an empty message aborts the commit. 
# On branch master 





Initial commit 


OO -J Ov Un 4» UJ hJ 捕 


LIE GL E E ac 


(use "git rm --cached <file>..." to unstage) 


new file: .gitignore 

new file: functional tests.py 
new file: manage.py 

new file: superlists/_ init _ 
new file: super lists/settings . py 
new file: superlists/urls.py 
new file: superlists/wsgi.py 


.git/COMMIT EDITMSG [.-]|Bs:b» Eg gitcommit 103,0x67 46,1/18 








1-3. 首次 Git 提交 





如 果 你 迫切 想 完成 整个 Git 操作 ， 此 时 还 要 学 习 如 何 把 代码 推送 到 云端 的 
VCS 托管 服务 中 ， 例 如 GitHub 或 BitBucket。 如 果 你 在 阅读 本 书 的 过 程 中 使 
用 不 同 的 电脑 ， 会 发 现 这 么 做 很 有 用 。 有 具体 的 操作 留 给 你 去 发 掘 ，GitHub 和 
BitBucket 的 文档 写 得 都 很 好 。 要 不 ， 你 可 以 等 到 第 9 章 ， 到 时 我 们 会 使 用 其 
中 一 个 服务 做 部 署 。 


























对 VCS 的 介绍 结束 。 祝 损 你 ! 你 使 用 Selenium 编写 了 一 个 功能 测试 ， 安 装 了 Django, Jf 
使 用 TDD 方式 ， 以 测试 山羊 赞许 的 、 先 写 测试 这 种 有 保障 的 方式 运行 了 Django。 在 继 
续 阅 读 第 2 章 之 前 ， 先 表扬 一 下 自己 吧 ， 这 是 你 应 得 的 奖励 。 


T 
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第 2 和 章 


使 用 unittest 模 块 扩展 功能 测试 





测试 目前 检查 的 是 Django 默认 的 “可 用 了 ”页 面 ， 修 改 一 下 ， 让 其 检查 我 们 想 在 真实 的 
网 站 首页 中 看 到 的 内 容 。 


是 时 候 公布 我 们 要 开发 什么 类 型 的 Web 应 用 了 一 一 一 个 待 办 事项 清单 网 站 。 开 发 这 种 网 
站 说 明 我 们 始终 追随 时 尚 ， 很 多 年 前 所 有 的 Web 开发 教程 都 介绍 如 何 开发 博客 ， 后 来 一 宽 
蜂 地 又 介绍 论坛 和 投票 应 用 ， 现 在 时 兴 的 是 待 办 事项 清单 。 

不 过 待 办 事项 清单 是 个 很 好 的 例子 。 很 明显 ， 这 种 应 用 简单 ， 只 显示 一 个 由 文本 字符 串 组 
成 的 列表 ， 因 此 很 容易 得 到 一 个 最 简 可 用 的 应 用 。 而 且 可 以 使 用 各 种 方式 扩展 功能 ， 例 如 
使 用 不 同 的 持久 模型 、 添 加 最 后 期 限 、 提 醒 和 分 享 功 能 ， 还 可 以 改进 客户 端 UI。 另 外 ， 不 
必 只 局 限于 列 出 待 办 事项 ， 这 种 应 用 可 以 列 出 任何 事项 。 最 重要 的 一 点 是 ， 通 过 这 种 应 
用 ， 可 以 演示 Web 开发 过 程 中 的 所 有 主要 步骤 ， 以 及 如 何在 各 个 步骤 中 运用 TDD 理念 。 


2.1 使 用 功能 测试 驱动 开发 一 个 最 简 可 用 的 应 用 
使 用 Selenium 实现 的 测试 可 以 驱动 真正 的 网 页 浏览 器 ， 让 我 们 能 从 用 户 的 角度 查看 应 用 是 
如 何 运作 的 。 因 此 ， 我 们 把 这 类 测试 叫 作 功 能 测试 。 


这 意味 着 ， 功 能 测试 在 某 种 程度 上 可 以 作为 应 用 的 说 明 书 。 功 能 测试 的 作用 是 跟踪 用 户 故 
事 (UserStory), ， 模 拟 用 户 使 用 某 个 功能 的 过 程 ， 以 及 应 用 应 该 如 何 响应 用 户 的 操作 。 









































术语 : 功能 测试 = 验收 测试 = 端 到 端 测试 
我 所 说 的 功能 测试 , 有 些 人 喜欢 称 之 为 验收 测试 (acceptance test) 或 端 到 端 测试 (end- 
to-end test), 。 这 类 测试 最 重要 的 作用 是 从 外 部 观察 整个 应 用 是 如 何 运作 的 。 另 一 个 本 
语 是 黑箱 测试 (black box test) ， 因 为 这 种 测试 对 所 要 测试 的 系统 内 部 一 无 所 知 。 
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功能 测试 应 该 有 一 个 人 类 可 读 、 容 易 理 解 的 故事 。 为 了 叙事 清楚 ， 可 以 把 测试 代码 和 代码 
注释 结合 起 来 使 用 。 编 写 新 功能 测试 时 ， 可 以 先 写 注释 ,勾勒 出 用 户 故 事 的 重点 。 这 样 写 
出 的 测试 人 类 可 读 ， 其 至 可 以 作为 一 种 讨论 应 用 需求 和 功能 的 方式 分 享 给 非 程序 员 看 。 
TDD 常 与 敏捷 软件 开发 方法 结合 在 一 起 使 用 ， 我 们 经 常 提 到 的 一 个 概念 是 “最 简 可 用 的 应 
用 ”， 即 我 们 能 开发 出 来 的 最 简单 的 而 且 可 以 使 用 的 应 用 。 下 面 我 们 就 来 开发 一 个 最 简 可 
用 的 应 用 ， 尽 早 试 水 。 

最 简 可 用 的 待 办 事项 清单 其 实 只 要 能 让 用 户 输入 一 些 待 办 事项 ， 并 且 用 户 下 次 访问 应 用 时 
这 些 事项 还 在 即 可 。 


打开 functional_tests.py， 编 写 一 个 类 似 下 面 的 故事 : 





















































functional tests.py 


from selenium import webdriver 
browser - webdriver.Firefox() 


# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 待 办 事项 应 用 
# 她 去 看 了 这 个 应 用 的 首页 
browser.get('http://localhost:8000') 











# 她 注意 到 网 页 的 标题 和 头 部 都 包含 “To-Do” 这 个 词 


assert 'To-Do' in browser.title 


# 应 用 邀请 她 输入 一 个 待 办 事项 








# 她 在 一 个 文本 框 中 输入 了 “Buy peacock feathers" (购买 孔 汰 羽毛 
# 伊 迪 丝 的 爱好 是 使 用 假 蝇 做 饵 钓鱼 


# 她 按 回 车 键 后 ， 页 面 更 新 了 
# 待 办 事项 表格 中 显示 了 “1: Buy peacock feathers" 


tt 
— 




































































# 页 面 中 又 显示 了 一 个 文本 框 ， 可 以 输入 其 他 的 竺 办 事项 
# 她 输入 了 “Use peacock feathers to make a fly" (使 用 孔雀 羽毛 做 假 蝇 ) 
# 伊 迪 丝 做 事 很 有 条 理 


页 面 再 次 更 新 ， 她 的 清单 中 显示 了 这 两 个 待 办 事项 



































+ 




















# 伊 迪 丝 想 知道 这 个 网 站 是 否 会 记 住 她 的 清单 
# 她 看 到 网 站 为 她 生成 了 一 个 唯一 的 URL 
# 而 且 页 面 中 有 一 些 文字 解说 这 个 功能 
# 她 访问 那个 URL， 发 现 她 的 待 办 事项 列表 还 在 


# 她 很 满意 ， 去 睡觉 了 








browser .quit() 
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我 们 有 个 词 来 形容 注释 

我 开始 在 Resolver 工作 时 ， 出 于 善意 习惯 在 代码 中 加 入 密密麻麻 的 详细 注释 。 我 的 同 
事 告诉 我 :“ 哈 利 ， 我 们 有 个 词 来 形容 注释 ， 我们 把 注释 叫 作 议 言 。 RREA: 可 我 
在 学 校 学 到 的 是 ， 注 释 是 好 的 习惯 啊 ? 
他 们 说 得 务 张 了 了。 注释 有 其 作用 ， 可 以 添加 上 下 文 ， 说 明代 码 的 目的 。 他 们 的 意思 是 ， 
简单 重复 代码 意图 的 注释 毫 无 意义 ， 例 如 : 

# 把 wibble 的 值 增加 1 

wibble += 1 
这 样 的 注释 不 仅 膏 无 意义 ， 还 有 一 定 危 险 ， 如 果 更 新 代码 后 没有 修改 注释 ， 会 误导 别 
人 。 我 们 要 努力 做 到 让 代码 可 读 ， 使 用 有 意义 的 变量 名 和 函数 名 ， 保 持 代码 结构 清晰 ， 
这 样 就 不 再 需要 通过 注释 说 明代 码 做 了 什么 ， 只 要 偶尔 写 一 些 注释 说 明 为 什么 这 么 做 。 
有 些 情况 下 注释 很 重要 。 后 文 会 看 到 ，Django 在 其 生成 的 文件 中 用 到 了 很 多 注释 ， 这 
是 解说 API 的 一 种 方式 。 而且 还 在 功能 测试 中 使 用 注释 描述 用 户 故事 一 一 把 测试 提炼 
成 一 个 连 员 的 故事 ， 确 保 我 们 始终 从 用 户 的 角度 测试 。 
这 个 领域 中 还 有 很 多 有 趣 的 知识 ， 例 如 行为 驱动 开发 (Behaviour Driven Development, 
详情 参见 附录 下) 和 测试 DSL (Domain Specific Language， 领 域 特定 语言 )。 这 些 知 识 
已 经 超出 本 书 的 范畴 了 ， 











你 可 能 已 经 发 现 了 ， 除 了 在 测试 中 加 入 注释 之 外 ， 我 还 修改 了 assert 这 行 代 码 ， 让 其 查找 
单词 “To-Do”， 而 不 是 “Django”。 这 意味 着 现在 我 们 期 望 测试 失败 。 运 行 这 个 测试 。 
首先 ， 启 动 服务 器 : 

$ python manage.py runserver 
然后 在 另 一 个 shell 中 运行 测试 : 


$ python functional tests.py 
Traceback (most recent call last): 
File "functional tests.py", line 10, in «module» 
assert 'To-Do' in browser.title 
AssertionError 


这 就 是 预期 失败 。 其 实 失 败 是 好 消息 ， 虽 不 像 测试 通过 那么 令 人 振奋 ， 但 至 少 事 出 有 因 ， 
证 明 测 试 编写 得 正确 。 


2.2 ”Python 标准 库 中 的 unittest 模 块 


上 述 测试 中 有 几 个 恼人 的 问题 需要 处 理 。 首 先 ,“AssertionError” 消 息 没 什么 用 ， 如 果 测 
试 能 指出 在 浏览 器 的 标题 中 到 底 找到 了 什么 就 好 了 。 其 次 ，Firefox 窗口 一 直 停留 在 桌面 
上 ， 如 果 能 自动 将 其 关闭 就 好 了 。 
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要 解决 第 一 个 问题 ， 可 以 使 用 assert 关键 字 的 第 二 个 参数 ， 写 成 : 


Firefox 窗 


assert 'To-Do' in browser.title, "Browser title was " + browser.title 




















口 可 在 try/finally 语句 中 关闭 。 但 这 种 问题 在 测试 中 很 常见 ， 标 准 库 中 的 


unittest 模块 已 经 提供 了 现成 的 解决 方法 。 使 用 这 种 方法 吧 ! 在 functional_tests.py 中 写 入 
如 下 代码 : 


你 可 d 
0 
e 


from selenium import webdriver 
import unittest 


class NewVisitorTest(unittest.TestCase): ©@ 


def setUp(self): © 
self.browser = webdriver.Firefox() 


def tearDown(self): © 
self.browser.quit() 


def test can start a list and retrieve it later(self): 








# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 待 办 事项 应 用 
# 她 去 看 了 这 个 应 用 的 首页 
self.browser.get('http://localhost:8000') 




















# 她 注意 到 网 页 的 标题 和 头 部 都 包含 “To-Do” 这 个 词 
self. BESEREIROS To-Do', self.browser.title) @ 
self.fail('Finish the test!') © 


# 应 用 邀请 她 输入 一 个 待 办 事项 
[其 余 的 注释 和 之 前 一 样 ] 














if nam  -- '' main ': QO 
unittest.main(warnings-'ignore') €& 
能 注意 到 以 下 几 个 地 方 了 。 


测试 组 织 成 类 的 形式 ， 继 承 自 unittest.TestCase。 


functional tests.py 


e 


测试 的 主要 代码 写 在 名 为 test can start a list and retrieve it later 的 方法 中 。 





名 字 以 test. 开头 的 方法 都 是 测试 方法 ， 由 测试 运行 程序 运行 。 类 中 可 以 定义 多 个 测 


试 方法 。 为 测试 方法 起 个 有 意义 的 名 字 是 个 好 主意 。 





setUp 和 tearDown 是 特殊 的 方法 ， 分 别 在 各 个 测试 方法 之 前 和 之 后 运行 。 我 使 用 这 两 
个 方法 打开 和 关闭 浏览 器 。 注 意 ， 这 两 个 方法 有 点 类 似 try/except 语句 ， 就 算 测 试 中 





出 错 了 ,也 会 运行 tearDown 方法 。' 测试 结束 后 ，Firefox 窗口 不 会 一 直 停 留 在 桌面 上 了 。 


使 用 self.assertIn 代替 assert 编写 测试 断言 。unittest 提供 了 很 多 这 种 用 于 编写 测 


试 断言 的 辅助 函数 ， 如 assertEquaL、assertTrue 和 assertFalse 等 。 更 多 断言 加 


数 参 见 unittest 的 文档 。 














1: 叭 有 一 个 特例 : 如 果 setup 方法 抛 出 异常 ，tearDown 方法 就 不 会 运行 











BJ ER 
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© ”不管 怎样 ，self.fail 都 会 失败 ， 生 成 指定 的 错误 消息 。 我 使 用 这 个 方法 提醒 测试 结束 了 。 


O 最 后 是 if _ name  -- 


Python 脚本 使 用 这 个 语句 检查 





' main 分 句 (如 果 你 之 前 没 见 过 这 种 用 法 ， 我 告诉 你 ， 
自己 是 否 在 命令 行 中 运行 ， 而 不 是 在 其 他 脚本 中 导入 )。 


我 们 调用 unittest.main() 启动 unittest 的 测试 运行 程序 ， 这 个 程序 会 在 文件 中 自动 
查找 测试 类 和 方法 ， 然 后 运行 。 
©  warnings-'ignore' 的 作用 是 禁止 抛 出 ResourceWarning 异常 。 写 作 本 书 时 这 个 异常 会 抛 
出 ， 但 你 阅读 时 我 可 能 已 经 把 这 个 参数 去 掉 了 。 你 可 以 把 这 个 参数 删 掉 ， 看 一 下 效果 。 





表扬 ! H 


来 试 一 下 这 个 测试 。 


$ python functional tests.py 














如 果 你 阅读 Django 关于 测试 的 文档 ， 可 能 会 看 到 有 个 名 为 LiveServerTestCase 
的 类 ， 而 且 想 知道 我 们 现在 能 否 使 用 它 。 你 能 阅读 这 份 友好 的 手册 真是 值得 
前 来 说 ，LiveServerTestCase 有 点 复杂 ， 但 我 保证 后 面 的 章节 会 用 到 。 




















Traceback (most recent call last): 
File "functional tests.py", line 18, in 
test can start a list and retrieve it later 
self.assertIn('To-Do', self.browser.title) 
AssertionError: 'To-Do' not found in 'Welcome to Django' 


Ran 1 test in 1.747s 


FAILED (failures-1) 


这 样 是 不 是 更 好 了 ? 这 个 测试 清理 了 Firefox 窗口 ， 显 示 了 一 个 排版 精美 的 报告 ， 指 出 运 











行 了 几 个 测试 ， 其 中 有 几 个 测试 失败 了 ， 而 且 assertIn 还 显示 了 一 个 有 利于 调试 的 错误 消 





息 。 太 棒 了 ! 


2.3 提交 


现在 是 提交 代码 的 好 时 机 ， 因 为 已 经 做 了 一 次 完整 的 修改 。 我 们 扩展 了 功能 测试 ， 加 入 注 





释 说 明 我 们 要 在 


EX, ^A 


c [H] 





可 用 的 待 办 事 ; 


项 清单 应 用 中 执行 哪些 操作 。 我 们 还 使 用 Python 中 的 





unittest 模块 及 其 提供 的 各 种 测试 辅助 函数 重 写 了 测试 。 


执行 git status 命令 ， 你 会 发 现 只 有 functional_tests.py 文件 的 内 容 变 化 了 。 然 后 执行 git diff 
命令 ， 查 看 上 一 次 提交 和 当前 硬盘 中 保存 内 容 之 间 的 差异 ， 你 会 发 现 functional_tests.py X 


件 的 变动 很 大 : 
$ git diff 


diff --git a/functional tests.py b/functional tests.py 
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index d333591..b0f22dc 100644 
- a/functional tests.py 
+++ b/functional tests.py 
QQ -1,6 +1,45 QQ 
from selenium import webdriver 
+import unittest 


-browser = webdriver.Firefox() 
-browser.get('http://localhost:8000') 
*class NewVisitorTest(unittest.TestCase): 


-assert 'Django' in browser.title 
def setUp(self): 
self.browser = webdriver.Firefox() 


def tearDown(self): 
self.browser.quit() 


— Rok G RR GM 


..] 


现在 执行 下 述 命令 : 


-a 的 


$ git commit -a 


意思 是 : 自动 添加 已 跟踪 文件 ( 即 已 经 提交 的 各 文件 ) 中 的 改动 。 上 述 命令 不 会 添加 


全 新 的 文件 (你 要 使 用 git add 命令 手动 添加 这 些 文件 ) 。 不 过 就 像 这 个 例子 一 样 ， 经 常 没 
有 添加 新 文件 ， 因 此 这 是 个 很 有 用 的 简便 用 法 。 

弹出 编辑 器 后 ， 写 入 一 个 描述 性 的 提交 消息 ， 比 如 “使 用 注释 编写 规格 的 首 个 功能 测试 ， 
而 且 使 用 了 unittest”, 

现在 我 们 身 处 一 个 绝妙 的 位 置 ， 可 以 开始 为 这 个 清单 应 用 编写 真正 的 代码 了 。 请 继续 往 下 




















阅读 。 
有 用 的 TDD 概念 
。 用 户 故 事 
从 用 户 的 角度 描述 应 用 应 该 如 何 运行 。 用 来 组 织 功能 测试 。 
。 预期 失败 
意料 之 中 的 失败 。 
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使 用 单元 测试 测试 简单 的 首页 





上 一 章 结束 时 功能 测试 是 失败 的 ， 失 败 消 息 指出 功能 测试 希望 网 站 的 首页 标题 中 包含 
“To-Do” 这 个 词 。 现 在 要 开始 编写 这 个 应 用 了 。 














警告 ， 要 动 真 格 的 了 
我 故意 把 前 两 章 写 得 这 么 友好 和 简单 。 从 现在 开始 ， 要 真正 编写 代码 了 。 提 前 给 你 打 
个 预防 针 : 有 些 地 方 会 出 错 。 你 看 到 的 结果 可 能 和 我 说 的 不 一 样 。 这 是 好 事 ， 因 为 这 
才 是 府 练 意志 的 学 习 经 历 。 


出 现 这 种 情况 ， 一 个 可 能 的 原 固 是， 我 表述 不 清 ， 让 你 误解 了 我 的 本 意 。 你 要 退 一 步 
想 想 要 实现 的 是 什么 ， 在 编辑 哪个 文件 ， 想 让 用 户 做 些 什么 ， 在 测试 什么 ， 为 什么 要 
测试 》 有 可 能 你 编辑 了 错误 的 文件 或 面 数 ， 或 者 运行 了 其 他 测试 。 我 觉得 停 下 来 想 一 
想 能 更 好 地 学 习 TDD， 比 照搬 所 有 操作 、 复 制 粘贴 代码 强 得 多 。 

还 有 一 种 原因 ， 可 能 真有 问题 。 认 真 阅读 错误 消息 (详情 请 参见 3.5 节 的 “阅读 调用 
跟踪 ") ， 你 会 找到 原因 的 。 可 能 是 漏 掉 了 一 个 过 号 或 末尾 的 斜 线 ， 或 者 某 个 Selenium 
查找 方法 少 写 了 一 个 “s”。 但 是 ,正如 Zed Shaw 所 说 ， 这 种 调试 也 是 学 习 过 程 的 重要 
组 成 部 分 ， 所 以 一 定 要 坚持 到 底 | 


如 果 你 真 的 卡 住 了 ， 随 时 可 以 给 我 发 电子 邮件 ， 或 者 在 谷歌 小 组 (https://groups.google.com/ 
forum/Z!forum/obey-the-testing-goat-book) 中 发 帖 。 祝 你 调试 愉快 ! 











3.1 第 一 个 Django 应 用 ， 第 一 个 单元 测试 


Django 鼓励 以 应 用 的 形式 组 织 代码 。 这 人 么 做 ， 一 个 项 目 中 可 以 放 多 个 应 用 ， 而 且 可 以 使 用 

















其 他 人 开发 的 第 三 方 应 用 ， 也 可 以 重用 自己 在 其 他 项 目 中 开发 的 应 用 。 我 承认 ， 我 自己 从 
没 真正 这 么 做 过 。 不 过 ， 应 用 的 确 是 组 织 代码 的 好 方法 。 


为 待 办 事项 清单 创建 一 个 应 用 : 
$ python manage.py startapp lists 


这 个 命令 会 在 superlists 文件 夹 中 创建 子 文件 夹 lists， 与 superlists 子 文件 夹 相 邻 ， 并 在 lists 

中 创建 一 些 占 位 文件 ， 用 来 保存 模型 、 视 图 以 及 目前 最 关注 的 测试 : 
superlists/ 

I— db.sqlite3 

| 一 functional tests.py 

|— lists 

FF admin.py 

[— apps.py 

l— | init .py 

— migrations 

| L— init .py 

I— models.py 


| 一 tests.py 
L— views.py 


| 一 manage.py 

-一 superlists 
— | init .py 
| 一 pycache . 
— settings.py 
I— urls.py 
L— wsgi.py 


ML s uu 2b 3 uu Lr 

3.2 单元 测试 及 其 与 功能 测试 的 区 别 

正如 给 事物 所 贴 的 众多 标签 一 样 ， 单 元 测试 和 功能 测试 之 间 的 界线 有 时 不 那么 清晰 。 不 

过 ， 二 者 之 间 有 个 基本 区 别 : 功能 测试 站 在 用 户 的 角度 从 外 部 测试 应 用 ， 单 元 测试 则 站 在 

程序 员 的 角度 从 内 部 测试 应 用 。 

我 遵从 的 TDD 方法 同时 使 用 这 两 种 类 型 测试 应 用 。 采 用 的 工作 流程 大 臻 如下。 

O 先 写 功 能 测试 ， 从 用 户 的 角度 描述 应 用 的 新 功能 。 

D 功能 测试 失败 后 ， 想 办 法 编写 代码 让 它 通 过 (或 者 说 至 少 让 当前 失败 的 测试 通过 )。 
此 时 ， 使 用 一 个 或 多 个 单元 测试 定义 希望 代码 实现 的 效果 ， 保 证 为 应 用 中 的 每 一 行 代 
码 (至 少 ) 编写 一 个 单元 测试 。 

(3) 单元 测试 失败 后 ， 编 写 最 少量 的 应 用 代码 ， 刚 好 让 单元 测试 通过 。 有 时 ， 要 在 第 2 步 
和 第 3 步 之 间 多 次 往复 ， 直 到 我 们 觉得 功能 测试 有 一 点 进展 为 止 。 

(4) 然后 ， 再 次 运行 功能 测试 ， 看 能 否 通过 ， 或 者 有 没有 进展 。 这 一 步 可 能 促使 我 们 编写 
一 些 新 的 单元 测试 和 代码 等 。 

由 此 可 以 看 出 ， 这 整个 过 程 中 ， 功 能 测试 站 在 高 层 驱动 开发 ， 而 单元 测试 则 从 低层 驱动 我 

们 做 些 什么 。 
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这 个 过 程 看 起 来 是 不 是 有 点 儿 烦 琐 ? 有 时 确实 如 此 ， 但 功能 测试 和 单元 测试 的 目的 不 完全 
一 样 ， 而 且 最 终 写 出 的 测试 代码 往往 区 别 也 很 大 。 











功能 测试 的 作用 是 帮助 你 开发 具有 所 需 功 能 的 应 用 ， 还 能 保证 你 不 会 无 意 中 
破坏 这 些 功能 。 单 元 测试 的 作用 是 帮助 你 编写 简洁 无 错 的 代码 。 


























理论 讲 得 够 多 了 ， 下 面 来 看 一 下 如 何 实践 。 


3.3 Django 中 的 单元 测试 


来 看 一 下 如 何 为 首页 视图 编写 单元 测试 。 打 开 新 生成 的 文件 lists/tests.py， 你 会 看 到 类 似 下 
面 的 内 容 : 





lists/tests.py 

from django.test import TestCase 

# 在 这 里 编写 测试 
Django 建议 我 们 使 用 TestCase 的 一 个 特殊 版 本 。 这 个 版 本 由 Django 提供， 是 标准 版 
unittest.TestCase 的 增强 版 ,添加 了 一 些 Django 专用 的 功能 ， 后 面 几 童 会 介绍 。 
你 已 经 知道 TDD 循环 要 从 失败 的 测试 开始 ， 然 后 再 编写 代码 让 其 通过 。 但 在 此 之 前 ， 不 
管 单元 测试 的 内 容 是 什么 ， 我 们 都 想 知道 自动 化 测试 运行 程序 能 否 运行 我 们 编写 的 单元 测 
试 。 直 接 运 行 functional_tests.py。 但 Django 生成 的 这 个 文件 有 点 儿 神 奇 ， 所 以 要 确认 一 
下 。 来 故意 编写 一 个 会 失败 的 思春 测试 : 






































lists/tests.py 


from django.test import TestCase 
class SmokeTest(TestCase): 


def test bad maths(self): 
self.assertEqual(1 * 1, 3) 


现在 ， 要 启动 神奇 的 Django 调试 运行 程序 。 和 之 前 一 样 ， 这 也 是 一 个 manage.py 命令 : 


$ python manage.py test 
Creating test database for alias 'default'... 


Traceback (most recent call last): 
File "/.../superlists/lists/tests.py", line 6, in test bad maths 
self.assertEqual(1 * 1, 3) 
AssertionError: 2 !- 3 
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Ran 1 test in 0.001s 


FAILED (failures-1) 
System check identified no issues (0 silenced). 
Destroying test database for alias 'default'... 


太 好 了 ， 看 起 来 能 运行 单元 测试 。 现 在 是 提交 的 好 时 机 : 


$ git status # 会 显示 一 个 消息 ,说 没 跟踪 lists/ 

$ git add lists 

$ git diff --staged # 会 显示 将 要 提交 的 内 容 差 异 

$ git commit -m "Add app for lists, with deliberately failing unit test" 
你 猪 得 没 错 ，-m 标志 的 作用 是 让 你 在 命令 行 中 编写 提交 消息 ， 这 样 就 不 需要 使 用 编辑 器 
了 。 如 何 使 用 Git 命令 行 取决 于 你 自己 ， 我 只 是 向 你 展示 我 经 常见 到 的 用 法 。 不 管 使 用 哪 
种 方法 ， 提 交 时 要 遵守 一 个 主要 原则 : 提交 前 一 定 要 审查 想 提 交 的 内 容 。 


3.4 ”Django 中 的 MVC、URL 和 视图 函数 


总 的 来 说 ，Django 遵守 了 经 典 的 模型 — 视图 - 控制 器 (Model-View-Controller, MVC) 模 
式 ， 但 并 没 严格 遵守 。Django 确实 有 模型 ， 但 视图 更 像 是 控制 器 ， 模 板 其 实 才 是 视图 。 不 
ib, MVC 的 思想 还 在 。 如 果 你 有 兴趣 ， 可 以 看 一 下 Django 常见 问题 解答 (https://docs. 
djangoproject.com/en/1.11/faq/general/) 中 的 详细 说 明 。 


抛 开 这 些 ，Django 和 任何 一 种 Web 服务 器 一 样 ， 主 要 任务 是 决定 用 户 访问 网 站 中 的 茶 个 
URL 时 做 些 什么 。Django 的 工作 流程 有 点 儿 类 似 下 述 过 程 。 


d) 针对 某 个 URL 的 HTTP 请 求 进入 。 
(2) Django 使 用 一 些 规则 决定 由 哪个 视图 函数 处 理 这 个 请 求 ( 这 一 步 叫 作 解 析 URL). 
(3) 选中 的 视图 函数 处 理 请 求 ， 然 后 返回 HTTP 响应 。 


因此 要 测试 两 件 


。 能 否 解析 网 站 根 路 径 〈 六) 的 URL， 将 其 对 应 到 我 们 编写 的 某 个 视图 函数 上 ? 
。 能 否 让 视图 函数 返回 一 些 HTML， 让 功能 测试 通过 ? 


先 编写 第 一 个 测试 。 打 开 lists/tests.py， 把 之 前 编写 的 思春 测试 改 成 如 下 代码 : 
































hl 





EN 
FF o 











lists/tests.py 


from django.urls import resolve 
from django.test import TestCase 
from lists.views import home_page @ 


class HomePageTest(TestCase): 
def test_root_url_resolves_to_home_page_view(self): 


found = resolve('/') 09 
self.assertEqual(found.func, home page) ©@ 
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这 段 代 码 是 什么 意思 呢 ? 

@ resolve 是 Django 内 部 使 用 的 函数 ， 用 于 解析 URL， 并 将 其 映射 到 相应 的 视图 函数 
上 。 检 查 解 析 网 站 根 路 径 “/” 时 ， 是 否 能 找到 名 为 home_page 的 函数 。 

e ”这 个 函数 是 什么 ? 这 是 接 下 来 要 定义 的 视图 函数 ， 其 作用 是 返回 所 需 的 HTML。 从 
import 语句 可 以 看 出 ， 要 把 这 个 函数 保存 在 文件 lists/views.py 中 。 

那么 ， 你 觉得 运行 这 个 测试 后 会 有 什么 结果 ? 


$ python manage.py test 
ImportError: cannot import name 'home page' 


这 个 结果 很 容易 预料 ， 不 过 错误 消息 有 点 无 趣 : 我 们 试图 导入 还 没 定义 的 函数 。 但 是 这 对 
TDD 来 说 算是 好 消息 ， 预 料 之 中 的 异常 也 算是 预期 失败 。 现 在 ， 功 能 测试 和 单元 测试 都 失 
败 了 ， 在 测试 山羊 的 庇护 下 ， 我 们 可 以 编写 代码 了 。 


3.5 终于 可 以 编号 一 些 应 用 代码 了 


很 兴奋 吧 ? 但 要 提醒 一 下 : 使 用 TDD 时 要 了 耐 着 性 子 ， 步 步 为 营 。 尤 其 是 学 习 和 起 步 阶 
段 , 一 次 只 能 修改 (或 添加 ) 一 行 代 码 。 每 一 次 修改 的 代码 要 尽量 少 ， 让 失败 的 测试 通过 
即 可 。 

我 是 故意 这 么 极端 的 。 还 记得 这 个 测试 为 什么 会 失败 吗 ? 因为 我 们 无 法 从 lists.views 中 
导入 home_page。 很 好 ， 来 修正 这 个 问题 一 一 仅 修 正 这 一 个 而 已 。 在 lists/views.py 中 写 入 
下 面 的 代码 : 

































































lists/views.py 


from django.shortcuts import render 








# 在 这 里 编写 视 区 
home_page = None 


你 可 能 会 想 :“ 不 是 开玩笑 吧 ? ” 

我 知道 你 会 这 么 想 ， 因 为 我 的 同事 第 一 次 给 我 演示 TDD 时 我 也 是 这 么 想 的 。 耐 心 一 点 ， 
稍 后 会 分 析 这 么 做 是 否 太极 端 。 现 在 ， 就 算 你 有 点 儿 恼 怒 ， 也 请 跟着 我 一 起 做 ， 看 添加 的 
这 段 代 码 能 否 帮助 我 们 编写 正确 的 代码 ， 向 前 迈进 一 小 步 。 

再 次 运行 测试 : 


$ python manage.py test 
Creating test database for alias 'default'... 

















Traceback (most recent call last): 
File "/.../superlists/lists/tests.py", line 8, in 
test root url resolves to home page view 
found = resolve('/') 
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File ".../django/urls/base.py", line 27, in resolve 
return get resolver(urlconf).resolve(path) 
File ".../django/urls/resolvers.py", line 392, in resolve 
raise Resolver404(('tried': tried, 'path': new path]) 
django.urls.exceptions.Resolver404: ('tried': [[«RegexURLResolver 
«RegexURLPattern list» (admin:admin) ^admin/»]], 'path': '') 


Ran 1 test in 0.002s 


FAILED (errors-1) 
System check identified no issues (0 silenced). 
Destroying test database for alias 'default'... 








阅读 调用 跟踪 


花 点 儿 时 间 讲 解 如 何 阅 读 调 用 跟踪 ， 因 为 在 TDD 中 经 常 要 做 这 件 事 。 很 快 你 就 能 学 会 
如 何 扫 视 调 用 跟踪 ， 找 出 解决 问题 的 线索 : 


ERROR: test root url resolves to home page view (lists.tests.HomePageTest) @ 


Traceback (most recent call last): 
File "/.../superlists/lists/tests.py", line 8, in 
test root url resolves to home page view 
found = resolve('/') © 


File ".../django/urls/base.py", line 27, in resolve 
return get resolver(urlconf).resolve(path) 
File ".../django/urls/resolvers.py", line 392, in resolve 


raise Resolver404(('tried': tried, 'path': new path]) 
django.urls.exceptions.Resolver404: ('tried': [[«RegexURLResolver © 
«RegexURLPattern list» (admin:admin) ^admin/»]], 'path': '') ©@ 


0 首先 应 该 查看 错误 本 身 。 有 时 你 只 需 查 看 这 一 处 ， 就 能 立即 找 出 问题 所 在 。 但 某 些 
时 候 ， 比 如 这 个 例子 ， 原 因 就 不 是 那么 明显 。 

O 接 下 来 要 确认 哪个 测试 失败 了 。 是 刚才 编写 按 预 期 会 失败 的 那个 测试 吗 ? 在 这 个 例 
子 中 ， 就 是 这 个 测试 。 

O 然后 查看 导致 失败 的 测试 代码 。 要 从 调用 跟踪 的 顶部 往 下 看 ， 找 出 错误 发 生 在 哪个 
测试 文件 中 哪个 测试 函数 的 哪 一 行 代 码 。 在 这 个 例子 中 ， 错 误 发 生 在 调用 resolve 
函数 解析 “/” 的 那 一 行 代码 。 

常 还 有 第 四 步 ， 即 继续 往 下 看 ， 查 找 问题 军 涉 的 应 用 代码 。 在 这 个 例子 中 全 是 Django 

的 代码 ， 不 过 在 本 书后 面 的 内 容 中 有 很 多 示例 都 用 到 了 这 一 步 。 


把 以 上 几 步 的 结果 综合 起 来 ， 可 以 解读 出 这 个 调用 跟踪 : 尝试 解析 “/” 时 ，Django 抛 
出 了 404 错误 。 也 就 是 说 ，Django 无 法 找到 “/” 的 URL 映射 。 下 面 来 解决 这 个 问题 。 
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3.6 urls.py 


测试 表明 ， 需 要 一 个 URL Bii. Django JH urls. py 文件 把 URL 映射 到 视图 函数 上 。 在 文人 
夹 superlists/superlists 中 有 个 主 urls.py 文件 ， 这 个 文件 应 用 于 整个 网 站 。 看 一 下 其 中 的 内 容 : 


tT 








superlists/urls.py 


superlists URL Configuration 


The "urlpatterns' list routes URLs to views. For more information please see: 
https://docs.djangoproject.com/en/1.11/topics/http/urls/ 
Examples: 
Function views 
1. Add an import: from my app import views 
2. Add a URL to urlpatterns: url(r'^$', views.home, name-'home') 
Class-based views 
1. Add an import: from other app.views import Home 
2. Add a URL to urlpatterns: url(r'^$', Home.as view(), name-'home') 
Including another URLconf 
1. Import the include() function: from django.conf.urls import url, include 
2. Add a URL to urlpatterns: url(r'^blog/', include('blog.urls')) 
from django.conf.urls import url 
from django.contrib import admin 


urlpatterns - [ 
url(r'^admin/', admin.site.urls), 


] 
和 之 前 一 样 ， 这 个 文件 中 也 有 很 多 Django 生成 的 辅助 注释 和 默认 建议 。 
url 条 目的 前 半 部 分 是 正则 表达 式 ， 定 义 适 用 于 哪些 URL。 后 半 部 分 说 明 把 请 求 发 往 何 
处 : d 验 导 入 的 视图 国 数 ， 或 是 别处 的 urls.py 文件 。 


第 一 个 示例 条 目 使 用 的 正则 表达 式 是 全， 表示 空 字符 串 。 这 和 网 站 的 根 路 径 ， 即 我 们 要 测 
试 的 “/” 一 样 吗 ? 分 析 一 下 ， 如 果 把 这 行 代码 的 注释 去 掉 会 发 生 什么 事 呢 ? 





如 果 你 从 未 见 过 正则 表达 式 ， 现 在 相信 我 所 说 的 就 行 。 不 过 你 要 记 在 心 上 ， 
稍 后 去 学 习 如 何 使 用 正则 表达 式 。 





我 们 还 将 去 掉 admin URL， 因 为 暂时 用 不 到 Django 的 管理 后 台 。 





super lists/urls.py 
from django.conf.urls import url 
from lists import views 


urlpatterns - [ 
url(r'^$', views.home page, name-'home'), 





行 命令 python manage.py test， 再 次 运行 测试 : 
[...] 


TypeError: view must be a callable or a list/tuple in the case of include(). 


Es 











确实 有 进展 ， 不 再 显示 404 错误 了 。 

调用 跟踪 有 点 乱 ， 不 过 最 后 一 行 却 指出 了 问题 所 在 : 单元 测试 把 地 址 “/” 和 文件 lists/ 
views.py 中 的 home page = None 连接 起 来 了 ， 现 在 测试 抱怨 home page 无 法 调用 。 由 此 我 
们 知道 ， 要 调整 一 下 ， 把 home page 从 None 变 成 真正 的 函数 。 记 住 ， 每 次 改动 代码 都 由 测 
试 驱 使 。 


回 到 文件 lists/views.py， 把 内 容 改 成 : 








lists/views.py 


from django.shortcuts import render 

















# 在 这 里 编写 视图 
def home page(): 
pass 


现在 视 试 的 结果 如 何 ? 


$ python manage.py test 
Creating test database for alias 'default'... 


Ran 1 test in 0.003s 


OK 
System check identified no issues (0 silenced). 
Destroying test database for alias 'default'... 


太 好 了 ， 第 一 个 测试 终于 通过 了 ! 这 是 一 个 重要 时 刻 ， 我 觉得 值得 提交 一 次 : 


$ git diff # 会 显示 urls.py、tests.py 和 views .py 中 的 变动 
$ git commit -am "First unit test and url mapping, dummy view" 


这 是 我 要 介绍 的 最 后 一 种 git commit 用 法 ， 把 a 和 nm 标 志 放 在 一 起 使 用 ， 意 思 是 添加 所 有 
已 跟踪 文件 中 的 改动 ， 而 且 使 用 命令 行 中 输入 的 提交 消息 。 








git commit -am 是 最 快捷 的 方式 ,但 关于 提交 内 容 的 反馈 信息 最 少 ， 所 以 在 
此 之 前 要 先 执 行 git status 和 git diff， 和 弄 清楚 要 把 哪些 改动 放 入 仓库 。 





3.7 为 视图 编写 单元 测试 


该 为 视图 编写 测试 了 。 此 时 ， 不 能 使 用 什么 都 不 做 的 函数 了 ， 我 们 要 定义 一 个 函数 ， 向 浏 
览 器 返回 真正 的 HTML 响应 。 打 开 lists/tests.py， 添 加 一 个 新 测试 方法 。 我 会 解释 每 一 行 
代码 的 作用 。 
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from django.urls import resolve 
from django.test import TestCase 
from django.http import HttpRequest 


from lists.views import home page 


class HomePageTest(TestCase): 


def test root url resolves to home page view(self): 
found = resolve('/') 
self.assertEqual(found.func, home page) 


def test home page returns correct html(self): 
request = HttpRequest() ©@ 
response = home page(request) 6 
html = response.content.decode('utf8') © 
self.assertTrue(html.startswith('«html»')) O 
self.assertIn('«title-To-Do lists«/title»', html) © 
self.assertTrue(html.endswith('«/html2')) O 


这 个 新 测试 方法 都 做 了 些 什 么 呢 ? 





lists/tests.py 


@ 创建 了 一 个 HttpRequest 对 象 ， 用 户 在 浏览 器 中 请 求 网 页 时 ，Django 看 到 的 就 是 


HttpRequest 对 象 。 


@ ”把 这 个 HttpRequest 对 象 传 给 home page 视图 ， 得 到 响应 。 听 说 响应 对 象 是 HttpResponse 


类 的 实例 时 ， 你 应 该 不 会 觉得 奇怪 。 








e ”然后 ,提取 响应 的 .content。 得 到 的 结果 是 原始 字 节 ， 即 发 给 用 户 浏览 器 的 0 和 1。 随 


后 ， 调 用 .decode()， 把 原始 字 节 转换 成 发 给 用 户 的 HTML 字符 
@ RAIMLA <html> 标签 开头 ， 并 在 结尾 处 关闭 该 标签 。 





pum 


o 

















e ”希望 响应 中 有 一 个 <title 标签 ， 其 内 容 包含 单 词 “To-Do lists” 一 一 因为 在 功能 测 
试 中 做 了 这 项 测试 。 

再 次 说 明 ， 单 元 测试 由 功能 测试 驱动 ， 而 且 更 接近 于 真正 的 代码 。 编 写 单元 测试 时 ， 按 照 

程序 员 的 方式 思考 。 


运行 单元 测试 ， 看 看 进展 如 何 : 


TypeError: home page() takes 0 positional arguments but 1 was given 


“单元 测试 /编写 代码 ”循环 
现在 可 以 开始 适应 TDD 中 的 单元 测试 /编写 代码 循环 了 。 


(D 在 终端 里 运行 单元 测试 ， 看 它们 是 如 何 失败 的 。 
(2) 在 编辑 器 中 改动 最 少量 的 代码 ， 让 当前 失败 的 测试 通过 。 











然后 不 断 重复 。 

想 保证 编写 的 代码 无 误 ， 每 次 改动 的 幅度 就 要 尽量 小 。 这 人 么 做 才能 确保 每 一 部 分 代码 都 有 
对 应 的 测试 监护 。 

乍 一 看 工作 量 很 大 ， 初 期 也 的 确 如 此 。 但 熟练 之 后 你 便 会 发 现 ， 即 使 步伐 迈 得 很 小 ， 编 程 
的 速度 也 很 快 。 我 们 在 工作 中 就 是 这 样 编写 实际 代码 的 。 

看 一 下 这 个 循环 可 以 运转 多 快 。 

。 小 幅 代码 改动 : 














lists/views.py 


def home page(request): 
pass 


。 运行 测试 


html = response.content.decode( 'utf8') 
AttributeError: 'NoneType' object has no attribute 'content' 


。 编写 代码 一 一 如 你 所 料 ， 使 用 django.http.HttpResponse: 


lists/views.py 


from django.http import HttpResponse 














# 在 这 里 编写 视图 
def home page(request): 
return HttpResponse() 




















。 再 运行 测试 : 
self.assertTrue(html.startswith('«html»')) 
AssertionError: False is not true 


。 再 编写 代码 : 























lists/views.py 


def home_page(request): 
return HttpResponse('«html»') 


。 运行 测试 : 
AssertionError: '<title>To-Do lists</title>' not found in '<html>' 
。 编写 代码 : 


lists/views.py 


def home page(request): 
return HttpResponse('«html»«title2To-Do lists«/title»') 
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。 运行 测试 一 一 快 通过 了 吧 ? 


self.assertTrue(html.endswith('</html>')) 
AssertionError: False is not true 


。 加 油 ， 最 后 一 击 : 


lists/views.py 


def home_page(request): 
return HttpResponse('<html><title>To-Do lists</title></html>') 


通过 了 吗 ? 


$ python manage.py test 
Creating test database for alias 'default'... 


Ran 2 tests in 0.001s 


OK 
System check identified no issues (0 silenced). 
Destroying test database for alias 'default'... 

















确实 通过 了 。 现 在 要 运行 功能 测试 。 如 果 已 经 关闭 了 开发 服务 器 ， 别 忘 了 启动 。 感 觉 这 是 


最 后 一 


次 运行 测试 了 吧 ， 真 是 这 样 吗 ? 
$ python functional tests.py 


FAIL: test can start a list and retrieve it later ( main .NewVisitorTest) 
Traceback (most recent call last): 
File "functional tests.py", line 19, in 
test can start a list and retrieve it later 
self.fail('Finish the test!') 
AssertionError: Finish the test! 


Ran 1 test in 1.609s 


FAILED (failures-1) 


失败 了 ， 怎 么 会 ? 哦 ， 原 来 是 那个 提醒 ? 是 吗 ? 是 的 ! 我 们 成 功 编写 了 一 个 网 页 ! 


， 我 觉得 这 样 结束 本 章 很 刺激 。 你 可 能 还 有 点 儿 摸 不 着 头脑 ， 或 许 还 想 知道 怎么 调整 








这 些 测试 ， 别 担心 ， 后 面 的 章节 会 讲 。 "me 近 收 尾 的 时 候 让 你 兴奋 一 下 。 


要 做 一 

















次 提交 ， 平 复 一 下 心情 ， 再 回想 学 到 了 什么 
$ git diff # 会 显示 tests.py 中 的 新 测试 方法 ， 以 及 views.py 中 的 视 医 


$ git commit -am "Basic view now returns minimal HTML" 

















这 一 章 内 容 真 丰富 啊 ! 为 什么 不 执行 git log 命令 回顾 一 下 我 们 取得 的 进展 呢 ? 或 许 还 


以 指定 





- -oneline 标志 : 





$ git log --oneline 

a6e6cc9 Basic view now returns minimal HTML 

450cO0f3 First unit test and url mapping, dummy view 

ea2b037 Add app for lists, with deliberately failing unit test 


Ee] 
不 错 ， 本 章 介绍 了 以 下 知识 。 


。 新 建 Django 应 用 。 

。 Django 的 单元 测试 运行 程序 。 

。 功能 测试 和 单元 测试 之 间 的 区 别 。 

* Django 解析 URL 的 方法 ，urls.py 文件 的 作用 。 
* Django 的 视图 国 数 ， 请 求 和 响应 对 象 。 

。 如 何 返回 简单 的 HTML, 











有 用 的 命 Ap L 令 和 概念 
。 启动 Django 的 开发 服务 器 
python manage.py runserver 
。 运行 功能 测试 
python functional_tests.py 
。 运行 单元 测试 
python manage.py test 
。“ 单 元 测试 /编写 代码 ”循环 
(1) 在 终端 里 运行 单元 测试 。 
(2) 在 编辑 器 中 改动 最 少量 的 代码 。 
(3) 重 复 上 两 步 。 
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第 4 章 


W (及 重 构 ) 的 目的 





现在 已 经 实际 演练 了 基本 的 TDD 流程 ， 该 停 下 来 说 说 为 什么 这 么 做 了 。 


我 想象 得 出 很 多 读者 心中 都 积压 了 一 些 挫败 感 ， 某 些 读 者 可 能 以 前 写 过 单元 测试 ， 另 一 些 

读者 可 能 只 想 快速 学 会 如 何 测 试 。 你 们 心中 有 些 疑 问 ， 比 如 说 : 

。 编写 的 测试 是 不 是 有 点 儿 多 了 ? 

。 其 中 一 些 测试 肯定 有 重复 吧 ， 比 如 功能 测试 和 单元 测试 之 间 ? 

。 我 的 意思 是 ， 你 为 什么 要 在 单元 测试 中 导入 django.core.urlresolvers 呢 ? 这 不 是 在 测 
试 作为 第 三 方 代 码 的 Django 吗 ? 我 觉得 没 必 要 这 么 做 ， 这 么 想 对 吗 ? 

。 单元 测试 有 点 儿 太 琐 碎 了 ， 测 试 一 行 声 明代 码 ， 而 且 只 让 函数 返回 一 个 常量 ， 这 么 做 难 
道 不 是 在 浪费 时 间 ? 我 们 是 不 是 应 该 把 时 间 腾 出 来 为 复杂 功能 编写 测试 ? 

。 “单元 测试 / 编写 代码 ”循环 中 的 小 幅 改 动 有 必要 吗 ? 我们 应 该 可 以 直接 跳 到 最 后 一 步 
"E? 我 想 说 ，home_page = None? 真 的 有 必要 吗 ? 

。 难道 现实 中 你 真 这 样 编写 代码 吗 ? 


年 轻 人 啊 ! 以 前 我 也 这 样 满腹 疑问 。 这 些 确实 是 很 好 的 问题 ， 其 实 ， 到 现在 我 也 经 常 问 自 
己 这 些 癌 题 。 真 的 值得 做 这 些 事 吗 ? 这 么 做 是 不 是 有 点 儿 富 目 ? 


4.1 编程 就 像 从 井 里 打 水 


编程 其 实 很 难 ， 我 们 的 成 功 往往 得 益 于 自己 的 聪明 才智 。 假 如 我 们 不 那么 聪明 ，TDD 就 能 助 
我 们 一 臂 之 力 。Kent Beck (TDD 理念 基本 上 就 是 他 发 明 的 ) 打 了 个 比方 。 试 想 你 用 绳子 从 井 
里 提 一 桶 水 ， 如 果 井 不 太 深 ， 而 且 桶 不 是 很 满 ， 提 起 来 很 容易 。 就 算 提 壮 满 一 桶 水 ， 刚 开始 
也 很 容易 。 但 要 不 了 多 久 你 就 昧 了 。TDD 理念 好 比 是 一 个 环 轮 ， 你 可 以 使 用 它 保存 当前 的 进 
度 ， 休 息 一 会 儿 ， 而 且 能 保证 进度 绝 不 倒退 。 这 样 你 就 没 必 要 一 直 那 么 聪明 了 (如 图 4-1). 
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4-1: 全 部 都 要 测试 


WE, 或许 你 基本 上 接受 TDD 是 个 好 主意 ， 但 仍然 认为 我 做 得 太极 端 了 ， 有 必要 测试 得 
这 么 细 、 步 子 这 么 小 吗 ? 

测试 是 一 种 技能 ， 不 是 天 生 就 会 的 。 因 为 很 多 结果 不 会 立刻 显现 ， 需 要 等 待 很 长 一 段 时 
间 ， 所 以 目前 你 要 强迫 自己 这 么 做 。 这 就 是 测试 山羊 的 图 片 想 要 表达 的 一 一 你 要 对 测试 顽 
固 一 点 儿 。 


























细 化 测试 每 个 函数 的 好 处 
就 目前 而 言 ， 测 试 简单 的 函数 和 常量 看 起 来 有 点 傻 。 


你 可 能 觉得 不 遵守 这 么 严格 的 规则 ， 漏 掉 一 些 单 元 测试 ， 应 该 也 算得 上 是 TDD。 但 是 在 
这 本 书 中 ， 我 所 演示 的 是 完整 而 严格 的 TDD 流程 。 像 学 习 武 术 中 的 招式 一 样 ， 在 不 受 
影响 的 可 榨 环 境 中 才能 让 技能 变 成 肌肉 记忆 。 现 在 看 起 来 之 所 以 琐碎 ， 是 因为 我 们 刚 开 
始 举 的 例子 很 简单 。 程 序 变 复杂 后 问题 就 来 了 ， 到 时 你 就 知道 测试 的 重要 性 了 。 你 要 面 
临 的 危险 是 ， 复 杂 性 逐渐 靠近 ， 而 你 可 能 没 发 觉 ， 但 不 久之 后 你 就 会 变 成 温水 煮 青 星 。 
我 赞成 为 简单 的 函数 编写 细 化 的 简单 测试 ， 关 于 这 一 观点 我 还 有 这 人 么 两 点 要 说 。 
首先 ， 既 然 测 试 那 么 简单 ， 写 起 来 就 不 会 花 很 长 时 间 。 所 以 ， 别 抱 急 了 ， 只 管 写 就 是 了 。 
其 次 ， 占 位 测试 很 重要 。 先 为 简单 的 函数 写 好 测试 ， 当 还 数 变 复杂 后 ， 这 道 心 理 障碍 
就 容易 迈 过 去 。 你 可 能 会 在 函数 中 添加 一 个 话语 身 ， 几 周 后 再 添加 一 个 for 循环 ， 不 
知 不 觉 间 就 将 其 变 成 一 个 基于 元 类 (meta-class) 的 多 态 树 状 结构 解析 器 了 。 因 为 从 一 
开始 你 就 编写 了 测试 ， 每 次 修改 都 会 自然 而 然 地 添加 新 测试 ， 最 终 得 到 的 是 一 个 测试 
良好 的 函数 。 相 反 ， 如 果 你 试图 判断 函数 什么 时 候 才 复杂 到 需要 编写 测试 的 话 ， 那 就 
大 主观 了 ,而 且 情 况 会 变 得 更 糟 ， 因 为 没有 占 位 测试 ， 此 时 开始 编写 测试 需要 投入 很 
多 精力 ， 每 次 改动 代码 都 冒 着 风险 ， 你 开始 拖延 ， 很 快 青蛙 就 者 熟 了 。 

不 要 试图 找 一 些 不 靠 谱 的 主观 规则 ， 去 判断 什么 时 候 应 该 编写 测试 ， 什 么 时 候 可 以 全 
身 而 退 。 我 建议 你 现在 遵守 我 制定 的 训练 方法 ， 因 为 所 有 技能 都 一 样 ， 只 有 花 时 间 学 
会 了 规则 才能 打破 规则 。 











接 下 来 继续 实践 。 














注 1: 原画 出 自 Allie Brosh 的 网 站 Hyperbole and a Half。 一 一 译 者 注 
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4.2 ”使 用 S| 交互 
前 一 章 结束 时 进展 到 哪里 了 ? 重新 运行 测试 找 出 答 


$ python functional tests.py 





-—n 


FAIL: test can start a list and retrieve it later ( main .NewVisitorTest) 


Traceback (most recent call last): 
File "functional tests.py", line 19, in 
test can start a list and retrieve it later 
self.fail('Finish the test!') 
AssertionError: Finish the test! 


Ran 1 test in 1.609s 
FAILED (failures-1) 
你 运行 了 吗 ? 是 不 是 看 到 一 个 错误 ， 说 加 载 页 面 出 错 或 者 无 法 连接 ? 我 也 看 到 了 。 这 是 因 


为 运行 测试 之 前 没有 使 用 manage.py runserver 启动 开发 服务 器 。 运 行 这 个 命令 ， 然 后 你 
会 看 到 我 们 期 待 的 那个 失败 消息 。 




















TDD 的 优点 之 一 是 ， 永 远 不 会 忘记 接 下 该 人 运行 测试 就 知道 要 


做 的 事 了 。 


失败 消息 说 “Finish the test” (结束 这 个 测试 ) ， 那 么 就 来 结束 它 吧 ! 打开 functional_tests.py 
文件 ， 扩 充 其 中 的 功能 测试 : 





functional tests.py 


from selenium import webdriver 

from selenium.webdriver.common.keys import Keys 
import time 

import unittest 


class NewVisitorTest(unittest.TestCase): 


def setUp(self): 
self.browser = webdriver.Firefox() 


def tearDown(self): 
self.browser.quit() 


def test can start a list and retrieve it later(self): 
# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 待 办 事项 应 用 


5 她 去 看 了 这 个 应 用 的 首页 
self.browser.get('http://localhost:8000') 


# 她 注意 到 网 页 的 标题 和 头 部 都 包含 “To-Do” 这 个 词 
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self.assertIn('To-Do', self.browser.title) 
header text = self.browser.find element by tag name('hi').text © 
self.assertIn('To-Do', header text) 


# 应 用 邀请 她 输入 一 个 待 办 事项 
inputbox = self.browser.find element by id('id new item') Q9 
self.assertEqual( 

inputbox.get attribute('placeholder'), 

'Enter a to-do item' 





) 


# 她 在 一 个 文本 框 中 输入 了 “Buy peacock feathers" (购买 孔雀 羽毛 ) 
# 伊 迪 丝 的 爱好 是 使 用 假 蝇 做 鱼饵 钓鱼 
inputbox.send keys('Buy peacock feathers') @ 


# 她 按 回 车 键 后 ， 页 面 更 新 了 

# 待 办 事项 表格 中 显示 了 “1: Buy peacock feathers" 
inputbox.send keys(Keys.ENTER) © 
time.sleep(1) Q 
































table = self.browser.find element by id('id list table') 
rows = table.find elements by tag name('tr') @ 
self.assertTrue( 

any(row.text -- '1: Buy peacock feathers' for row in rows) 


) 


# 页 面 中 又 显示 了 一 个 文本 框 ， 可 以 输入 其 他 的 待 办 事项 

# 她 输入 了 “Use peacock feathers to make a fly" (使 用 孔雀 羽毛 做 假 蝇 ) 
# 伊 迪 丝 做 事 很 有 条 理 

self.fail('Finish the test!') 


# 页 面 再 次 更 新 ， 她 的 清单 中 显示 了 这 两 个 待 办 事项 
[...] 
























































我 们 使 用 了 Selenium 提供 的 几 个 用 来 查找 网 页 内 容 的 方法 : find element by tag name, 


find element by id 和 find_elements_by_tag_name (注意 有 个 s， 也 就 是 说 这 个 方法 会 
返回 多 个 元 素 ) 。 


© Keys% 


我 们 还 使 用 了 send keys, Xz Selenium 在 输入 框 中 输入 内 容 的 方法 。 





( 别 忘 了 导入 ) 的 作用 是 发 送 回 车 键 等 特殊 的 按键 。” 























按 下 回 车 键 后 页 面 会 刷新 。time.steep 的 作用 是 等 待 页 面 加载 完 毕 ， 这 样 才能 针对 新 页 


面 下 断言 。 这 叫 “ 显 式 等 待 ”( 特 别 简单 ， 第 6 章 将 加 以 改进 ) 。 





小 心 Selenium 中 find_element_by... 和 find_elements_by... iX P Æ 
数 的 区 别 。 前 者 返回 一 个 元 素 ， 如 果 找 不 到 就 抛 出 异常 ， 后 者 返回 一 个 列 
表 ， 这 个 列表 可 能 为 空 。 




















ü 





Keys 类 。 


E2: 这 里 可 以 直接 使 用 字符 串 "\n"， 但 因为 Keys 还 能 发 送 Ctrl 等 特殊 的 按键 ， 所 以 我 觉得 有 必要 用 一 下 
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还 有 ， 留 意 一 下 any 国 数 ， 它 是 Python 中 的 原生 函数 ， 却 鲜 为 人 知 。 不 用 我 解释 这 个 函数 
的 作用 了 吧 ? 使 用 Python Zeit xx Z^ TES. 
不 过 ， 如 果 你 不 懂 Python 的 话 ， 我 告诉 你 ，any 函数 的 参数 是 个 生成 器 表达 式 (generator 
expression) ， 类 似 于 列表 推导 (list comprehension) ， 但 比 它 更 为 出 色 。 你 需要 仔细 研究 这 
个 概念 。 你 可 以 搜索 Guido 名 为 “From List Comprehensions to Generator Expressions” 的 文 
章 。 读 完 之 后 你 就 会 知道 ， 这 个 函数 可 不 仅仅 是 为 了 让 编程 恢 意 。 
看 一 下 测试 进展 如 何 : 
$ python functional tests.py 
[1 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: h1 
解释 一 下 ， 测 试 报错 在 页 面 中 找 不 到 <h 元 素 。 看 一 下 如 何在 首页 的 HTML 中 加 入 这 个 
元 素 。 
大 幅 修 改 功 能 测试 后 往往 有 必要 提交 一 次 。 初 稿 中 我 没 这 么 做 ， 想 通 之 后 就 后 悔 了 ， 可 古 
已 经 和 其 他 代码 混在 一 起 提交 了 。 其 实 提交 得 越 频 繁 越 好 : 


$ git diff # 会 显示 对 functional_tests.py 的 改动 
$ git commit -am "Functional test now checks we can input a to-do item" 


* rA 3 ME Le Eu 7 Tat 

4.3 遵守 “不 测试 常量 ”规则 ， 使 用 模板 解决 这 
"1B 

个 问题 
看 一 下 lists/tests.py 中 的 单元 测试 。 现 在 ， 要 查找 特定 的 HTML 字符 串 ， 但 这 不 是 测试 
HTML 的 高 效 方法 。 一 般 来 说 ， 单 元 测试 的 规则 之 一 是 不 测试 常量 。 以 文本 形式 测试 
HTML 很 大 程度 上 就 是 测试 常量 。 
换 句 话说 ， 如 果 有 如 下 的 代码 : 

wibble = 3 

在 测试 中 就 不 太 有 必要 这 么 写 : 


from myprogram import wibble 
assert wibble == 3 


单元 测试 要 测试 的 其 实 是 逻辑 、 流 程控 制 和 配置 。 编 写 断 言 检 测 HTML 字符 串 中 是 否 有 指 
定 的 字符 序列 ， 不 是 单元 测试 应 该 做 的 。 

mH, Æ Python 代码 中 插入 原始 字符 串 真 的 不 是 处 理 HTML 的 正确 方式 。 我 们 有 更 好 
的 方法 ， 那 就 是 使 用 模板 。 如 果 把 HTML 放 在 一 个 扩展 名 为 htm 的 文件 中 ， 先 不 说 其 
他 好 处 ， 单 就 得 到 更 好 的 名 法 高 亮 支持 这 一 点 而 言 也 值 了 。Python 领域 有 很 多 模板 框架 ， 
Django 有 自己 的 模板 系统 ， 而 且 很 好 用 。 来 使 用 这 个 模板 系统 吧 。 



















































































4.3.1 使 用 模板 重 构 
现在 要 做 的 是 让 视图 国 数 返 回 完全 一 样 的 HIML， 但 使 用 不 同 的 处 理 方 式 。 这 个 过 程 叫 作 
重 构 ， 即 在 功能 不 变 的 前 提 下 改进 代码 。 
功能 不 变 是 最 重要 的 。 如 果 重 构 时 添加 了 新 功能 ， 很 可 能 会 产生 问题 。 重 构 本 身 也 是 一 门 
学 问 ， 有 专门 的 参考 书 一 一 Martin Fowler 写 的 《 重 构 》。 
重 构 的 首要 原则 是 不 能 没有 测试 。 幸 好 我 们 在 做 测试 驱动 开发 ， 测 试 已 经 有 了 。 检 查 一 下 
测试 能 否 通过 ， 测 试 能 通过 才能 保证 重 构 前 后 的 表现 一 致 : 

$ python manage.py test 

[...] 

OK 
很 好 ! JEJE HTML 字符 串 提 取出 来 写 入 单独 的 文件 。 新 建 用 于 保存 模板 的 文件 夹 lists/ 
templates， 然 后 新 建文 件 lists/templates/home.html， 再 把 HTML 写 入 这 个 文件 ^, 





















































lists/templates/home.html 


<html> 
<title>To-Do lists</title> 
</html> 


HERIDA, ELT! 接 下 来 修改 视 区 











S 
BS 
EE 











lists/views.py 
from django.shortcuts import render 
def home page(request): 
return render(request, 'home.html') 

现在 不 自己 构建 HttpResponse 对 象 了 ， 转 而 使 用 Django 中 的 render 国 数 。 这 个 国 数 
的 第 一 个 参数 是 请 求 对 象 (原因 稍 后 说 明 )， 第 二 个 参数 是 演 染 的 模板 名 。Django 会 自 
动 在 所 有 的 应 用 目录 中 搜索 名 为 templates 的 文件 夹 ， 然 后 根据 模板 中 的 内 容 构建 一 个 
HttpResponse 对 象 。 














模板 是 Django 中 一 个 很 强大 的 功能 ， 使 用 模板 的 主要 优势 之 一 是 能 
Python 变量 代入 HTML 文本 。 现 在 还 没 用 到 这 个 功能 ， 不 过 后 面 的 章节 会 
用 到 。 这 就 是 为 什么 使 用 render 和 render to string ( 稍 后 用 到 )， 而 不 用 
原生 的 open 函数 手动 从 硬盘 中 读 取 模 板 文 件 。 

看 一 下 模板 是 否 起 作用 了 : 


$ python manage.py test 
Ersal 











注 3: 有 些 人 喜欢 使 用 和 应 用 同名 的 子 文件 夹 ( 即 lists/templates/lists)， 然 后 使 用 lists/home.html 引用 这 
个 模板 ， 这 叫 作 “模板 命名 空间 >。 我 觉得 对 小 型 项 目 来 说 使 用 模板 命名 空间 太 复 杂 了 ， 不 过 在 
大 型 项 目 中 可 能 有 用 武之 地 。 详 情 参阅 Django 教程 (https://docs.djangoproject.com/en/1.11/intro/ 
tutorial03/#write-views-that-actually-do-something ) 。 
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又 过 


0 
© 
e 
© 


ERROR: test_home_page_returns_correct_html (lists.tests.HomePageTest) @ 
Traceback (most recent call last): 
File "/.../superlists/lists/tests.py", line 17, in 
test home page returns correct html 
response = home page(request) € 
File "/.../superlists/lists/views.py", line 5, in home page 
return render(request, 'home.html') @ 
File "/usr/local/lib/python3.6/dist-packages/django/shortcuts.py", line 48, 
in render 
return HttpResponse(loader.render to string(*args, **kwargs), 
File "/usr/local/lib/python3.6/dist-packages/django/template/loader.py", line 
170, in render to string 
t = get template(template name, dirs) 
File "/usr/local/lib/python3.6/dist-packages/django/template/loader.py", line 
144, in get template 
template, origin - find template(template name, dirs) 
File "/usr/local/lib/python3.6/dist-packages/django/template/loader.py", line 
136, in find template 
raise TemplateDoesNotExist(name) 
django.template.base.TemplateDoesNotExist: home.html © 


Ran 2 tests in 0.004s 
到 一 次 分 析 调 用 跟踪 的 机 会 。 

先 看 错误 是 什么 测试 无 法 找到 模板 。 

然后 确认 是 哪个 测试 失败 : 很 显然 是 测试 视图 HTML 的 测试 。 

然后 找到 导致 失败 的 是 测试 中 的 哪 一 行 : 调用 home page 函数 那 行 。 
最 后 ， 在 应 用 的 代码 中 找到 导致 失败 的 部 分 : 调用 render 函数 那 段 。 











那 为 什么 Django 找 不 到 模板 呢 ? 模板 在 lists/templates 文件 夹 中 ， 它 就 该 放 在 这 个 位 置 啊 。 
原因 是 还 没有 正式 在 Django 中 注册 lists 应 用 。 执 行 startapp 命令 以 及 在 项 目 文件 夹 中 


存放 一 个 应 用 还 不 够 ， 你 要 告诉 Django 确实 要 开发 一 个 应 用 ， 并 把 这 个 应 用 添加 到 文 作 








tr 








settings.py 中 。 这 么 做 才能 保证 万 无 一 失 。 打 开 settings.py， 找 到 变量 INSTALLED APPS, iB 
Lists 加 进去 : 





superlists/settings.py 


# Application definition 


INSTALLED APPS - [ 
'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'lists', 











可 以 看 出 ， 默 认 已 经 有 很 多 应 用 了 。 只 需 把 Lists 加 到 列表 的 末尾 。 别 忘 了 在 行 尾 加 上 去 
m. 这么 做 虽然 不 是 必须 的 ， 但 如 果 忘 了 ，Python 会 把 不 在 同一 行 的 两 个 字符 串 连 起 来 ， 
到 时 你 就 傻眼 了 。 
现在 可 以 再 运行 测试 看 看 : 

$ python manage.py test 


self.assertTrue(html .endswith('</html>')) 
AssertionError: False is not true 


糟糕 ， 还 是 无 法 通过 。 


你 能 否 看 到 这 个 错误 ， 取 决 于 你 使 用 的 文本 编辑 器 是 否 会 在 文件 的 最 后 添加 
一 个 空 行 。 如 果 没 看 到 ， 你 可 以 跳 过 下 面 几 段 ， 直 接 跳 到 测试 通过 那 部 分 。 





不 过 确实 有 进展 。 看 起 来 测试 找到 模板 了 ， 但 最 后 三 个 断言 失败 了 。 很 显然 输出 的 末尾 出 
了 问题 。 我 使 用 print (repr(html)) 调试 这 个 问题 ， 发 现 是 因为 转 用 模板 后 在 响应 的 末尾 
引入 了 一 个 额外 的 空 行 (\n)。 按 下 面 的 方式 修改 可 以 让 测试 通过 : 




















lists/tests.py 
self.assertTrue(html.strip().endswith('«/html»')) 


RAMASE, Wit HTML 文件 末尾 的 空白 并 不 重要 。 再 运行 测试 看 看 : 
$ python manage.py test 
Ls] 
OK 
对 代码 的 重 构 结束 了， 测试 也 证 实 了 重 构 前 后 的 表现 一 致 。 现 在 可 以 修改 测试 ， 不 再 测试 
常量 ， 检 查 是 否 泻 染 了 正确 的 模板 。 
4.3.2 ”Django 测试 客户 端 


测试 是 否 正确 泻 染 模板 的 一 种 方法 是 在 测试 中 手动 渲染 模板 ， 然 后 与 视图 返回 的 结果 做 比 
较 。 为 此 ， 可 以 利用 Django 提供 的 render_to_string 函数 : 

















lists/tests.py 


from django.template.loader import render to string 


[...] 


def test home page returns correct html(self): 
request - HttpRequest() 
response - home page(request) 
html = response.content.decode('utf8') 
expected html - render to string('home.html') 
self.assertEqual(html, expected html) 


但 这 样 测 试 有 点 笨拙 ， 而 且 转 来 转 去 调用 .decode() 和 .stripO 大 牵扯 精力 。 其 实 ，Django 
提供 的 测试 客户 端 (Test Client) 才 是 检查 使 用 哪个 模板 的 原生 方式 。 相 应 的 测试 如 下 所 示 : 
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lists/tests.py 
def test home page returns correct html(self): 
response = self.client.get('/') © 


html = response.content.decode('utf8') 6 
self.assertTrue(html.startswith('«html»')) 
self.assertIn('«title-To-Do lists«/title»', html) 
self.assertTrue(html.strip().endswith('«/html»')) 


self.assertTemplateUsed(response, 'home.html') © 

@ 不 再 手动 创建 HttpRequest 对 象 ， 也 不 再 直接 调用 视图 国 数 ， 而 是 调用 self .client.get, 
并 传人 要 测试 的 URL, 

e ”暂时 保留 这 一 行 ， 确 保 一 切 与 之 前 一 样 正常 。 

©  .assertTenplateUsed 是 Django TestCase 类 提供 的 测试 方法 ， 用 于 检查 响应 是 使 用 哪 
个 模板 泻 染 的 注意， 这 个 方法 只 能 测试 通过 测试 客户 端 获 取 的 响应 )。 

这 个 测试 依然 能 通过 : 
Ran 2 tests in 0.016s 



































OK 
我 对 没 失败 的 测试 始终 有 所 怀疑 ， 所 以 故意 做 点 破坏 : 


lists/tests.py 


self.assertTemplateUsed(response, 'wrong.html') 
这 样 还 能 看 看 错误 消息 是 什么 : 


AssertionError: False is not true : Template 'wrong.html' was not a template 
used to render the response. Actual template(s) used: home.html 


消息 的 内 容 很 有 帮助 ! 现在 把 断言 改 回去 ， 顺 便 把 旧 的 断言 删 掉 。 此 外 ， 还 可 以 把 原来 的 
test root url resolves 测试 删除 ， 因 为 Django 测试 客户 端 已 经 隐 式 测试 过 了 。 我 们 把 两 
个 元 长 的 测试 精简 成 了 一 个 ! 











lists/tests.py (ch041010) 
from django.test import TestCase 
class HomePageTest(TestCase): 
def test uses home template(self): 


response - self.client.get('/') 
self.assertTemplateUsed(response, 'home.html') 


注意 ， 这 里 的 重点 是 “不 要 测试 常量 ， 而 应 该 测试 实现 方式 ”。 很 好 ! * 

















注 4: 你 是 不 是 发 现 某 些 代 码 清单 旁 有 ch0410xx 这 样 的 文本 ， 而 且 还 不 知道 那 是 什么 意思 ? 这 是 本 书 示 例 
仓库 中 特定 提交 (https//github.com/hjwp/book-example/commits/chapter philosophy. and refactoring) 
的 引用 ,为 本 书 中 的 测试 (https://github.com/hjwp/Book-TDD-Web-Dev-Python/tree/master/tests) 使 用 
也 就 是 这 本 关于 测试 的 书 中 的 测试 的 测试 ， 显 然 ， 测 试 自身 也 需要 测试 。 
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为 什么 不 一 直 使 用 Django 测试 客户 端 ? 
你 可 能 会 问 :“ 为 什么 不 从 一 开始 就 使 用 Django WRAP HE?” AMEP, RAR 


A^ 

绍 相 关 概 念 ， 尽 量 使 学 习 曲 线 保 持平 缓 ; 其 次 ， 你 可 能 不 会 一 直 使 用 Django 构建 应 
用 ， 而 且 相 关 的 测试 工具 也 不 是 永远 可 用 但 是 直接 调用 函数 ， 然 后 检查 响应 是 永 
远 可 以 采用 的 方法 。 

此 外 ，Django 测试 客户 端 也 有 不 足 之 处 ， 后 文 会 讨论 完 
户 端 推 动向 前 的 “整合 ”测试 之 间 的 区 别 。 但 就 目前 而 
的 选择 。 


44 ”关于 重 构 


这 个 重 构 的 例子 很 烦琐 。 但 正如 Kent Beck 在 Test-Driven Development: By Example 一 书 中 
所 说 的 :“ 我 是 推荐 你 在 实际 工作 中 这 么 做 吗 ? 不 是 。 我 只 是 建议 你 要 知道 怎么 按照 这 种 
方式 做 。 

其 实 ， 写 这 一 部 分 时 我 的 第 一 反应 是 先 修改 代码 ， 直 接 使 用 assertTemplateUsed 国 数 ， 删 
除 那 三 个 多 余 的 断言 ， 只 在 演 染 得 到 的 结果 中 检查 期 望 看 到 的 内 容 ， 然 后 再 修改 代码 。 但 
要 注意 ， 如 果真 这 么 做 了 可 能 就 会 犯错 ， 因 为 我 可 能 不 会 在 模板 中 编写 正确 的 <html> 和 
«title» 标签 ， 而 是 随便 写 一 些 字符 串 。 





全 隔离 的 单元 测试 与 由 测试 客 
言 ， 测 试 客户 端 尚且 算是 务实 




















重 构 时 ， 修 改 代码 或 者 测试 ， 但 不 能 同时 修改 。 





在 重 构 的 过 程 中 总 有 超前 几 步 的 冲动 ， 想 对 应 用 的 功能 做 些 改动 ， 不久， 修改 的 文件 就 会 
变 得 越 来 越 多 ， 最 终 你 会 忘记 自己 身 在 何 处 ， 而 且 一 切 都 无 法 正常 运行 了 。 如 果 你 不 想 让 
自己 变 成 “ 重 构 猫 ”( 如 图 4-2)， 迈 的 步子 就 要 小 一 点 ， 把 重 构 和 功能 调整 完全 分 开 来 做 。 











» v. Codejrefactoring 


sa 





aA. Code refactoring 











图 4-2: 重 构 猫 一 一 记得 要 看 完整 的 动态 GIF 
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后 面 会 再 次 遇 到 重 构 猫 ， 用 来 说 明 头 脑 发 热 、 一 次 修改 很 多 内 容 带 来 的 后 
果 。 你 可 以 把 这 只 猫 想象 成 卡通 片 中 浮现 在 另 一 个 肩膀 上 的 魔鬼 ， 它 和 测试 
山羊 的 观点 是 对 立 的 ， 总 给 些 不 好 的 建议 。 




















重 构 后 最 好 做 一 次 提交 : 


$ git status # 会 看 到 tests.py、views.py、settings.py 以 及 新 建 的 templates 文 件 夹 
$ git add . # 还 会 添加 尚未 跟踪 的 templates 文 件 夹 

$ git diff --staged # 审查 我 们 想 提交 的 内 容 

$ git commit -m "Refactor home page view to use a template" 


4.5 接着 修改 首页 


现在 功能 测试 还 是 失败 的 。 修 改 代 码 ， 让 它 通 过 。 因 为 HTML 现在 保存 在 模板 中 ， 可 以 尽 
情 修改 ， 无 须 编 写 额 外 的 单元 测试 。 我 们 需要 一 个 «hi» 元 素 : 











lists/templates/home.html 


«html» 
«head» 
«title»To-Do lists</title> 
</head> 
<body> 
<h1>Your To-Do list</h1> 
</body> 
</html> 


看 一 下 功能 测试 是 否认 同 这 次 修改 : 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: [id-"id new item"] 


不 错 ， 继 续 修改 : 


lists/templates/home.html 


[s] 
«hi»Your To-Do list«/hi» 
«input id-"id new item" /> 
</body> 
[1 
现在 呢 ? 


AssertionError: '' !- 'Enter a to-do item' 
加 上 占 位 文字 : 


lists/templates/home.html 


«input id-"id new item" placeholder-"Enter a to-do item" /> 





得 到 了 下 述 错误 ; 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: [id-"id list table"] 


因此 要 在 页 面 中 加 入 表格 。 目 前 表格 是 空 的 : 


lists/templates/home.html 


«input id-"id new item" placeholder-"Enter a to-do item" /> 
«table id-"id list table" 
</table> 

</body> 


现在 功能 测试 的 结果 如 何 ? 


File "functional tests.py", line 43, in 
test can start a list and retrieve it later 
any(row.text -- '1: Buy peacock feathers' for row in rows) 
AssertionError: False is not true 


Ai AJL. "TLASEHETEHEIBIRUSUSTTE, MRE Ihi dida A AAA any 函数 导致 
的 ， 或 者 更 准确 地 说 是 assertTrue， 因 为 没有 提供 给 它 明确 的 失败 消息 。 可 以 把 自 定义 的 
错误 消息 传 给 unittest 中 的 大 多 数 assertX 方法 : 




















functional tests.py 


self.assertTrue( 
any(row.text -- '1: Buy peacock feathers' for row in rows), 
"New to-do item did not appear in table" 


) 
再 次 运行 功能 测试 ， 应 该 会 看 到 我 们 编写 的 消息 : 
AssertionError: False is not true : New to-do item did not appear in table 
不 过 现在 如 果 想 让 测试 通过 ， 就 要 真正 处 理 用 户 提交 的 表单 ， 但 这 是 下 一 章 的 话题 。 
现在 做 个 提交 吧 : 


$ git diff 
$ git commit -am "Front page HTML now generated from a template" 


多 亏 这 次 重 构 ， 视 图 能 演 染 模板 了 ， 也 不 再 测试 常量 了 ， 现 在 准备 好 处 理 用 户 的 输入 了 。 
4.6 总结: TDD 流程 


至 此 ， 我 们 已 经 在 实践 中 见识 了 TDD 流程 中 涉及 的 所 有 主要 概念 。 
。 功能 测试 。 











。 单元 测试 。 
。 “单元 测试 / 编写 代码 ”循环 。 
。 重 构 。 
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现在 要 稍微 总 结 一 下 ， 或 许可 以 画 个 流程 图 。 请 原谅 我 ,做 了 这 么 多 年 管理 顾问 ， 养 成 了 
这 个 习惯 。 不 过 流程 图 也 有 好 的 一 面 ， 能 清楚 地 表明 流程 中 的 循环 。 


TDD 的 总 体 流 程 是 什么 呢 ? 参见 图 4-3。 
































编写 测试 doe 是 否 需 要 重 构 ? 














4-3: TDD 的 总 体 流程 














首先 编写 一 个 测试 ， 运 行 这 个 测试 看 着 它 失 败 。 然 后 编写 最 少量 的 代码 取得 一 些 进 展 ， 再 
运行 测试 。 如 此 不 断 重 复 ， 直 到 测试 通过 为 止 。 最 后 ， 或 许 还 要 重 构 代 码 ， 测 试 能 确保 不 
破坏 任何 功能 。 

如 果 既 有 功能 测试 ， 又 有 单元 测试 ， 该 怎么 运用 这 个 流程 呢 ?” 你 可 以 把 功能 测试 当 作 循环 
的 一 种 高 层 视 角 ， 而 “编写 代码 让 功能 测试 通过 ”这 一 步 则 是 另 一 个 小 型 TDD 循环 ， 这 
个 小 循环 使 用 单元 测试 ， 如 图 4-4 所 示 。 

编写 一 个 功能 测试 ， 看 着 它 失 败 。 接 下 来 , “编写 代码 让 功能 测试 通过 ”这 一 步 是 一 个 小 
型 TDD 循环 : 编写 一 个 或 多 个 单元 测试 ， 然 后 进入 “单元 测试 /编写 代码 ”循环 ， 直 到 单 
元 测试 通过 为 止 。 然 后 回 到 功能 测试 ， 查 看 是 否 有 进展 。 这 一 步 还 可 以 多 编写 一 些 应 用 代 
码 ， 再 编写 更 多 的 单元 测试 ， 如 此 一 直 循 环 下 去 。 

涉及 功能 测试 时 应 该 怎么 重 构 呢 ? 这 就 要 使 用 功能 测试 检查 重 构 前 后 的 表现 是 否 一 致 。 不 
过 ， 你 可 以 修改 、 添 加 或 删除 单元 测试 ， 或 者 使 用 单元 测试 循环 修改 实现 方式 。 

功能 测试 是 应 用 能 否 正 常 运行 的 最 终 评判 ， 而 单元 测试 只 是 整个 开发 过 程 中 的 一 个 辅助 工具 。 
这 种 看 待 事物 的 方式 有 时 叫 作 “ 双 循 环 测 试 驱动 开发 "。 本 书 的 优秀 技术 审 校 人 员 之 一 
Emily Bache 写 了 一 篇 博客 ， 从 不 同 的 视角 讨论 了 这 个 话题 ， 推 荐 你 阅读 ， 名 为 “Coding Is 
Like Cooking", 
















































































应 用 是 否 


编写 最 少量 的 代码 


图 4-4: 包含 功能 测试 和 单元 测试 的 TDD 流程 
接 下 来 的 章节 会 更 深入 地 探索 这 个 工作 流程 中 的 各 个 组 成 部 分 。 














如 何 检查 你 的 代码 ， 以 及 在 必要 时 跳 着 阅读 
书 中 使 用 的 所 有 代码 示例 都 可 以 到 我 放 在 GitHub 中 的 仓库 (https://github.com/hjwp/book- 
example/) 中 获取 。 因 此 ， 如果 你 想 拿 自己 的 代码 和 我 的 比较 ,可 以 到 这 个 仓库 中 看 一 下 。 
每 一 章 的 代码 都 放 在 单独 的 分 支 中 ， 各 分 支 采用 简短 形式 命名 ， 比 如 说 本 章 的 示例 在 
chapter philosophy and refactoring 这 个 分 支 中 。 这 是 本 章 结束 时 代码 的 快照 。 
所 有 分 支 的 代码 请 至 http://www.ituring.com.cn/book/2052 下 载 。 附 录 丁 说 明了 如 何 使 用 
Git 比较 你 我 的 代码 。 
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第 5 章 


保存 用 户 输入 测试 数据 库 








要 获取 用 户 输入 的 待 办 事项 ， 发 送 给 服务 器 ， 这 样 才能 使 用 某 种 方式 保存 待 办 事项 ， 然 后 
再 显示 给 用 户 查看 。 


刚 开 始 写 这 一 章 时 ， 我 立即 采用 了 我 认为 正确 的 设计 方式 : 为 清单 和 待 办 事项 创建 儿 个 模 
型 ， 为 新 建 清单 和 待 办 事项 创建 一 组 不 同 的 URL， 编 写 三 个 新 视图 函数 ， 又 为 这 些 操作 编 
写 六 七 个 新 的 单元 测试 。 不 过 我 还 是 忍 住 了 没 这 么 做 。 虽 然 我 十 分 确定 自己 很 聪明 ， 能 一 
次 处 理 所 有 问题 ,但 是 TDD 的 重要 思想 是 必要 时 一 次 只 做 一 件 事 。 所 以 我 决定 放 慢 脚步 ， 
每 次 只 做 必要 的 操作 ， 让 功能 测试 向 前 迈 出 一 小 步 即 可 。 

这 么 做 是 为 了 演示 TDD 对 迭代 式 开发 方法 的 支持 一 一 这 种 方法 不 是 最 快 的 ， 但 最 终 仍 能 
把 你 带 到 目的 地 。 使 用 这 种 方法 还 有 个 不 错 的 附带 好 处 : 我 可 以 一 次 只 介绍 一 个 新 概念 ， 
例如 模型 、 处 理 POST 请 求 和 Django 模板 标签 等 ， 不 必 一 股 脑 儿 全 抛 给 你 。 

并 不 是 说 你 不 能 事先 考虑 后 面 的 事 ， 或 者 不 能 发 挥 自己 的 聪明 才智 。 下 一 章 我 们 会 稍微 多 
使 用 一 点 儿 设计 和 预见 思维 ， 展 示 如 何在 TDD 过 程 中 运用 这 些 思维 方式 。 不 过 现在 ， 我 
们 要 坚持 自己 是 无 知 的， 测试 让 做 什么 就 做 什么 。 


5.1 编写 表单 ， 发 送 POST 请 求 


上 一 章 末尾 ， 测 试 指 出 无 法 保存 用 户 的 输入 。 现 在 ， 要 使 用 标准 的 HTML POST 请 求 。 
虽然 有 点 无 了 获 ， 但 发 送 过 程 很 简单 。 后 文 我 们 会 见识 到 各 种 有 趣 的 HTML5 和 JavaScript 
用 法 。 

为 了 让 浏览 器 发 送 POST 请 求 ， 我 们 要 做 两 件 事 。 
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(1) 
2) 





给 «input» 元 素 指定 name= 属性 。 
把 它 放 在 «form» 标签 中 ， 并 为 «form» 标签 指定 method="POST" 属 


性 。 











据 此 调整 一 下 lists/templates/home.html 中 的 模板 : 


lists/templates/home.html 


«hi»Your To-Do list«/hi» 
«form method-"POST"- 

«input name-"item text" id-"id new item" placeholder-"Enter a to-do item" /> 
</form> 


<table id="id_list_table"> 





BitgwfrXENWIA. SAR — T MERE, PRBEZ PN: 


如 有 果 功 能 测试 出 平 意料 地 失败 了 ， 可 以 做 下 面 几 件 事 ， 找 出 问题 所 在 。 











$ python functional tests.py 
PETI 
Traceback (most recent call last): 

File "functional_tests.py", line 40, in 
test_can_start_a_list_and_retrieve_it_later 

table = self.browser.find element by id('id list table') 

[ei] 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: [id-"id list table"] 





lini 














。 添加 print 语句 ， 输 出 页 面 中 当前 显示 的 文本 是 什么 。 
。 改进 错误 消息 ， 显 示 当 前 状态 的 更 多 信息 。 

。 亲自 和 手动 访问 网 站 。 

。 在 测试 执行 过 程 中 使 用 time.sleep 暂停 。 


本 

















会 分 别 介绍 这 儿 种 调试 方法 ， 不 过 我 发 现 自己 经 常 使 用 time.sleep。 下 面试 一 下 这 种 





方法 。 
其 实 ， 在 错误 发 生 之 前 就 已 经 休眠 了 。 那 就 延长 休眠 时 间 : 


functional tests.py 


# 按 回 车 键 后 ， 页 面 更 新 了 

# 待 办 事项 表格 中 显示 了 “1: Buy peacock feathers" 
inputbox.send keys(Keys.ENTER) 

time.sleep(10) 

















table = self.browser.find element by id('id list table') 


如 有 果 Selenium 运行 得 很 慢 ， 你 可 能 已 经 发 现 了 这 一 问题 。 现 在 再 次 运行 功能 测试 ， 就 有 机 
会 看 看 到 底 发 生 了 什么 : 你 会 看 到 一 个 如 图 5-1 所 示 的 页 面 ， 显示 了 Django 提供 的 很 多 调 
试 信 息 。 
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403 Forbidden - Mozilla Firefox x 
File Edit View History Bookmarks Tools Help 
(1403 Forbidden lej 


$9 | 图 localhost8000 v @| | 图 v Google Q 





Forbidden (403) 
CSRF verification failed. Request aborted. 


Help 


Reason given for failure: 
CSRF cookie not set 


In general, this can occur when there is a genuine Cross Site Request Forgery, or when Django's CSRF mechanism has not been used 
correctly. For POST forms, you need to ensure: 
* Your browser is accepting cookies. 
* The view function uses RequestContext for the template, instead of context. 
* In the template, there is a s csrf. token %} template tag inside each POST form that targets an internal URL. 
* If you are not using csrfviewMiddleware, then you must use csrf. protect on any views that use the csrf. token template 
tag, as well as those that accept the POST data. k 


You're seeing the help section of this page because you have pesus = True in your Django settings file. Change that to False, and only the 
initial error message will be displayed. 


You can customize this page using the CSRF. FAILURE VIEW setting. 














x WebDriver 











5-1: Django 中 的 调试 页 面 ， 显 示 有 CSRF 错误 





如 果 你 从 未 听 说 过 跨 站 请 求 伪 造 (Cross-Site Request Forgery, CSRF) 漏洞 ， 现 在 就 去 
查 资料 吧 。 和 所 有 安全 漏洞 一 样 ， 研 究 起 来 很 有 趣 。CSRF 是 一 种 不 寻常 的 、 使 用 系 
统 的 巧妙 方式 。 


在 大 学 攻读 计算 机 科学 学 位 时 ， 出 于 责任 感 ， 我 报名 学 习 了 安全 课程 单元 。 这 个 单元 可 
能 很 枯燥 乏味 ， 但 我 觉得 最 好 还 是 学 一 下 。 结 果 证 明 ， 这 是 所 有 课程 中 最 吸引 人 的 单 
元 ， 充 满 了 黑客 的 乐趣 ， 你 要 在 特定 的 心境 下 思考 如 何 通 过 意 想不到 的 方式 使 用 系统 。 


我 要 推荐 学 这 门 课程 时 使 用 的 课本 ，Ross Anderson 写 的 Security Engineering, X% P 
没有 深入 讲解 纯粹 的 加 密 机 制 ， 而 是 讨论 了 很 多 意料 之 外 的 话题 ， 例 如 开锁 、 伪 造 银 
行 标 据 和 喷 墨 打印 机 墨盒 的 经 济 原 理 ， 以 及 如 何 使 用 重 放 攻击 (replay attack) 戏弄 南 
非 空 军 的 飞机 等 。 这 是 本 大 部 头 书 ， 大 约 3 英寸 厚 ， 但 相信 我 ， 绝 对 值得 一 读 。 








Django 针对 CSRE 的 保护 措施 是 在 生成 的 每 个 表单 中 放置 一 个 自动 生成 的 令 牌 ， 通过 这 个 
令 牌 判断 POST 请 求 是 否 来 自 同 一 个 网 站 。 之 前 的 模板 都 是 纯粹 的 HIML， 在 这 里 要 首次 
体验 Django 模板 的 魔力 ， 使 用 模板 标签 (template tag). 添加 CSRF 令 牌 。 模 板 标 签 的 句法 
是 花 括号 和 百 分 号 形式 ， 即 OS... 六 一 一 这 种 写法 很 有 名 ， 要 连续 多 次 同时 按 两 个 键 ， 是 
世界 上 最 麻烦 的 输入 方式 。 




















lists/templates/home.html 


«form method-"POST"- 
«input name-"item text" id-"id new item" placeholder-"Enter a to-do item" /> 
{% csrf token X) 

</form> 


演 染 模板 时 ，Django 会 把 这 个 模板 标签 替换 成 一 个 «input type="hidden"> 元 素 ， 其 值 是 
CSRF 令 牌 。 现 在 运行 功能 测试 ， 会 看 到 一 个 预期 失败 ; 

AssertionError: False is not true : New to-do item did not appear in table 
因为 time.sleep 还 在 ， 所 以 测试 会 在 最 后 可 以 看 到 ， 提交 表单 后 新 添加 的 


待 办 事项 不 见 了 ， 页 面 刷新 后 又 显示 了 一 个 空 表 单 。 这 是 因为 还 设 连 接 服务 器 让 它 处 理 
POST 请 求 ， 所 以 服务 器 忽略 请 求 ， 24 


其 实 ， 现 在 可 以 删 掉 tine.sleep 了 : 














functional tests.py 


# 待 办 事项 表格 中 显示 了 “1: Buy peacock feathers" 
inputbox.send keys(Keys.ENTER) 
time.sleep(1) 





table = self.browser.find element by id('id list table') 


5.2 在 服务 器 中 处 理 POST 请 求 
还 没 为 表单 指定 action= 属性 ， 因 此 提交 表单 后 默认 返回 之 前 党 染 的 页 面 ( 即 “/”)， 这 个 
页 面 由 视图 函数 hone, page 处 理 。 下 面 修改 这 个 视图 函数 ， 让 它 能 处 理 POST 请 求 。 


这 意味 着 要 为 视图 函数 home. page 编写 一 个 新 的 单元 测试 。 打 开 文 件 lists/tests.py， 在 
HomePageTest 类 中 添加 一 个 新 方法 : 
































lists/tests.py (ch051005) 


def test uses home template(self): 
response = self.client.get('/') 
self.assertTemplateUsed(response, 'home.html') 


def test can save a POST request(self): 
response = self.client.post('/', data-('item text': 'A new list item')) 
self.assertIn('A new list item', response.content.decode()) 





为 了 发 送 POST 请 求 ， 我 们 调用 self.client.post, (£A data 参数 ， 指 定 想 发 送 的 表单 数 
据 。 然 后 再 检查 POST 请 求 演 染 得 到 的 HTML 中 是 否 有 指定 的 文本 。 运 行 测试 后 ， 会 看 到 
预期 的 失败 ， 


$ python manage.py test 
[...] 





AssertionError: 'A new list item' not found in '<html>\n <head>\n 
<title>To-Do lists</title>\n </head>\n <body>\n <h1>Your To-Do 
list«/hi»Xn «form method-"POST"»An «input name="item text" 
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PEN 
</body>\n</html>\n' 


为 了 让 测试 通过 ， 可 以 添加 一 个 if 语句， 为 POST 请 求 提 供 一 个 不 同 的 代码 执行 路 径 。 按 
照 典 型 的 TDD 方式 ， 先 故意 编写 一 个 思春 的 返回 值 ; 








lists/views.py 
from django.http import HttpResponse 
from django.shortcuts import render 


def home page(request): 
if request.method -- 'POST': 
return HttpResponse(request.POST['item text']) 
return render(request, 'home.html') 








这 样 单元 测试 就 能 通过 了 ， 但 这 并 不 是 我 们 真正 想 要 做 的 。 我 们 真正 想 要 做 的 是 把 POST 
请 求 提交 的 数据 添加 到 首页 模板 的 表格 里 。 


5.3 ”把 Python 变 量 传 入 模板 中 泻 3 


前 面 已 经 粗略 展示 了 Django 的 模板 句法 ， 现 在 是 时 候 领略 它 的 真正 强大 之 处 了 ， 即 从 视 
图 的 Python 代码 中 把 变量 传人 HTML 模板 。 




















先 介 绍 在 模板 中 使 用 哪 种 句法 引入 Python 对 象 。 要 使 用 的 符号 是 (C... H, BAUE 
串 的 形式 显示 对 象 : 


lists/templates/home.html 
«body» 
«hi»Your To-Do list«/hi» 
«form method-"POST"» 
«input name-"item text" id-"id new item" placeholder-"Enter a to-do item" /> 
{% csrf token %} 
</form> 


<table id="id_list_table"> 
<tr><td>{{ new item text }}</td></tr> 
</table> 
</body> 








有 要 调整 单元 测试 ， 检 查 是 否 依然 使 用 这 个 模板 : 


lists/tests.py 
def test can save a POST request(self): 


response = self.client.post('/', data-('item text': 'A new list item']) 
self.assertIn('A new list item', response.content.decode()) 
self.assertTemplateUsed(response, 'home.html') 


跟 预期 一 样 ， 这 个 测试 会 失败 : 


AssertionError: No templates used to render the response 








很 好 ， 故 意 编写 的 思春 返回 值 已 经 骗 不 过 测试 了 ， 因 此 要 重 写 视图 函数 ， 把 POST 请 求 中 
的 参数 传人 模板 。render 函数 的 第 三 个 参数 是 一 个 字典 ， 把 模板 变量 的 名 称 映 射 在 值 上 : 


lists/views.py (ch051009) 


def home page(request): 
return render(request, 'home.html', { 
'new item text': request.POST['item text'], 


n 
然后 再 运行 单元 测试 


ERROR: test uses home template (lists.tests.HomePageTest) 
[3] 
File "/.../superlists/lists/views.py", line 5, in home page 
'new item text': request.POST['item text'], 


[...] 


django.utils.datastructures.MultiValueDictKeyError: "'item text'" 
看 到 的 是 意料 之 外 的 失败 。 
如 果 你 记得 阅读 调用 跟踪 的 方法 ， 就 会 发 现 这 次 失败 其 实 发 生 在 另 一 个 测试 中 。 我 们 让 正 
FE 处 理 的 测试 通过 了 ， 但 是 这 个 单元 测试 却 导致 了 一 个 意 想不到 的 结果 ， 或 者 称 之 为 “ 回 
VH" : 破坏 了 没有 POST 请 求 时 执行 的 那 条 代码 路 径 。 
这 就 是 测试 的 要 义 所 在 。 不 错 ， 发 生 这 样 的 事 是 可 以 预料 的 ， 但 如 果 运 气 不 好 或 者 没有 注 
意 到 呢 ? 这 时 测试 就 能 避免 破坏 应 用 功能 ， 而 且 ， 因 为 我 们 在 使 用 TDD， 所 以 能 立即 发 现 
什么 地 方 有 问题 。 无 须 等 待 质量 保证 团队 的 反馈 ， 也 不 用 打开 浏览 器 自己 动手 在 网 站 中 点 
来 点 去 ， 直 接 就 能 修正 问题 。 这 次 失败 的 修正 方法 如 下 : 



































Ra 
































lists/views.py 


def home page(request): 
return render(request, 'home.html', { 
'new item text': request.POST.get('item text', ''), 
n 


如 果 不 理解 这 段 代 码 ， 可 以 查阅 dict.get 的 文档 。 
这 个 单元 测试 现在 应 该 可 以 通过 了 。 看 一 下 功能 测试 的 结果 如 何 : 


AssertionError: False is not true : New to-do item did not appear in table 



































如 果 你 现在 或 者 在 本 章 其 他 地 方 看 到 的 功能 测试 报错 与 这 里 不 同 ， 而 是 与 
StaleElementReferenceException 有 关 ， 你 可 能 就 需要 增加 tine.sleep 的 显 
式 等 待 时 间 


E 


章 。 














错误 消息 没 太 大 帮助 。 使 用 另 一 种 功能 测试 的 调试 技术 : 改进 错误 消息 。 这 或 许 是 最 有 建 
设 性 的 技术 ， 因 为 改进 后 的 错误 消息 一 直 存 在 ， 可 以 协助 调试 以 后 出 现 的 错误 : 
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functional tests.py (ch051011) 


self.assertTrue( 
any(row.text -- '1: Buy peacock feathers' for row in rows), 
f"New to-do item did not appear in table. Contents were:Mn[table.text)]" © 


) 


@ ”你 以 前 可 能 没有 见 过 这 种 句法 ， 这 是 Python 新 的 f 字 符 串 句法 (算是 Python 3.6 最 令 
人 激动 的 新 特性 )。 只 需 在 字符 串 前 面 加 上 一 个 f， 你 就 能 使 用 花 括号 插入 局 部 变量 
详情 请 参见 Python 3.6 的 版 本 说 明 。 


改进 后 ， 测 试 给 出 了 更 有 用 的 错误 消息 : 


AssertionError: False is not true : New to-do item did not appear in table. 
Contents were: 
Buy peacock feathers 


知道 怎么 改 效 果 更 好 吗 ?” 稍 微 让 断言 别 那么 灵巧 。 你 可 能 还 记得 ， 函 数 any 让 我 很 满意 ， 
但 预览 版 的 一 个 读者 (感谢 Jason) 建议 我 使 用 一 着 更 简单 的 实现 方式 ， 把 六 行 assertTrue 
换 成 一 行 assertIn: 


























o 

















functional tests.py (ch051012) 


self.assertIn('1: Buy peacock feathers', [row.text for row in rows]) 
这 样 好 多 了 。 自 作 聪 明 时 一 定 要 小 心 ， 因 为 你 可 能 把 问题 过 度 复杂 化 了 。 修 改 之 后 自动 获 
得 了 下 面 的 错误 消息 : 


self.assertIn('1: Buy peacock feathers', [row.text for row in rows]) 
AssertionError: '1: Buy peacock feathers' not found in ['Buy peacock feathers'] 


就 当 这 是 我 应 得 的 惩罚 吧 。 




















如 果 功 能 测试 指出 的 错误 是 表格 为 空 (not found in [])， 那 就 检查 一 下 
«input» 标签 ， 看 看 有 没有 正确 设 定 name="item_text" 属性 。 如 果 没 有 这 个 
属性 ， 用 户 的 输入 就 不 能 与 request .POST 中 正确 的 键 关联 。 








上 述 错误 消息 息 的 意思 是 ， 功 能 测试 在 枚 举 列 表 中 的 项 目 时 希望 第 一 个 项 目 以 “1:” 开 头 。 
让 测试 通过 最 快 的 方法 是 修改 模板 时 “ 作 癣 ”: 





lists/templates/home.html 
«tr»«td»1: {{ new item text )j«/td»«/tr» 





“ 遇 红 / 变 绿 / 重 构 ”和 三 角 法 
“单元 测试 /编写 代码 ”循环 有 时 也 叫 “ 遇 红 / 变 绿 / 重 构 ”。 
。 先 写 一 个 会 失败 的 单元 测试 ( 遇 红 ) 。 
。 编写 尽 可 能 简单 的 代码 让 测试 通过 (BER). ， 就 算 作 尊 也 行 。 
。 重 构 ， 改 进 代码 ， 让 其 更 合理 。 
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那么 ， 在 重 构 阶段 应 该 做 些 什么 呢 ? AATA A ZU MR SL dO E RE 05 AN 2E x, 8I] 
满意 的 实现 方式 呢 ? 


一 种 方法 是 消除 重复 : 如 果 测 试 中 使 用 了 神奇 常量 (例如 列表 项 目前 面 的 “1:”)， 而 
且 应 用 代码 中 也 用 了 这 个 常量 ， 这 就 算是 重复 ， 此 时 就 应 该 重 构 。 把 神奇 常量 从 应 用 
代码 中 删 掉 往往 意味 着 你 不 能 再 作 产 了 。 


我 觉得 这 种 方法 有 点 不 太 明确 ， 所 以 经 常 使 用 第 二 种 方法 ， 这 种 方法 叫 作 “三 角 法 ”: 
如 果 编 写 无 法 让 你 满意 的 作 次 代码 〈 例 如 返回 一 个 神奇 的 常量 ) 就 能 让 测试 通过 ,就 
再 写 一 个 测试 ， 强 制 自己 编写 更 好 的 代码 。 现 在 就 要 使 用 这 种 方法 ， 扩 充 功 能 测试 ， 
检查 输入 的 第 二 个 列表 项 目 中 是 否 包 念 “2:”。 























现在 功能 测试 能 执行 到 self.fail('Finish the test!') 了。 如 果 扩 充 功能 测试 ， 检 查 表格 
中 添加 的 第 二 个 待 办 事项 (复制 粘贴 是 好 帮手 )， 我 们 会 发 现 刚才 使 用 的 简单 处 理 方式 不 
奏效 了 : 








functional tests.py 





# 页 面 中 还 有 一 个 文本 框 ， 可 以 输入 其 他 的 待 办 事项 

# 她 输入 了 “Use feathers to make a fly" (使 用 孔雀 羽毛 做 假 蝇 ) 
# 伊 迪 丝 做 事 很 有 条 理 
inputbox = self.browser.find element by id('id new item') 
inputbox.send keys('Use peacock feathers to make a fly') 
inputbox.send keys(Keys.ENTER) 

time.sleep(1) 
































# 页 面 再 次 更 新 ， 清 单 中 显示 了 这 两 个 待 办 事项 
table = self.browser.find element by id('id list table') 
rows - table.find elements by tag name('tr') 
self.assertIn('1: Buy peacock feathers', [row.text for row in rows]) 
self.assertIn( 
'2: Use peacock feathers to make a fly', 
[row.text for row in rows] 

















) 


# 伊 迪 丝 想 知道 这 个 网 站 是 否 会 记 住 她 的 清单 
# 她 看 到 网 站 为 她 生成 了 一 个 唯一 的 URL 

# 页 面 中 有 一 些 文字 解说 这 个 功能 
self.fail('Finish the test!') 





# 她 访问 那个 URL， 发 现 待 办 事项 清单 还 在 
很 显然 ， 这 个 功能 测试 会 返回 一 个 错误 : 


AssertionError: '1: Buy peacock feathers' not found in ['1: Use peacock 
feathers to make a fly'] 
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5.4 事 不 过 三 ， 三 则 重 构 


在 继续 之 前 ， 先 看 一 下 功能 测试 中 的 代码 异味 。 检查 清单 表格 中 新 添加 的 待 办 事项 时 ， 
用 了 三 个 几乎 一 样 的 代码 块 。 编 程 中 有 个 原则 叫 作 不 要 自我 重复 (Don't Repeat Yourself, 
DRY) ， 按 照 真 言 “ 事 不 过 三 ,三 则 重 构 ” 的 说 法 ， 运 用 这 个 原则 。 复 制 粘 贴 一 次 ， 可 能 
还 不 用 删除 重复 ， 但 如 果 复 制 粘 贴 了 三 次 ， 就 该 删除 重复 了 。 
要 先 提交 目前 已 编写 的 代码 。 虽 然 网 站 还 有 重大 瑕 症 〈 只 能 处 理 一 个 待 办 事项 ) ， 但 仍然 
取得 了 一 定 进 展 。 这 些 代码 可 能 要 全 部 重 写 ， 也 可 能 不 用 ， 不 管 怎样 ， 重 构 之 前 一 定 要 提交 : 
$ git diff 
# 会 看 到 functional_tests.py、home.html、tests.py 和 views .py 中 的 变动 
$ git commit -a 
然后 重 构 功能 测试 。 可 以 定义 一 个 行 间 国 数 ， 不 过 这 样 会 稍微 搅乱 测试 流程 ， 还 是 用 辅助 方 
法 吧 。 记 住 ， 只 有 名 字 以 test 开头 的 方法 才 会 作为 测试 运行 ， 可 以 根据 需求 使 用 其 他 方法 。 

































































functional tests.py 


def tearDown(self): 
self.browser.quit() 


def check for row in list table(self, row text): 
table = self.browser.find element by id('id list table') 
rows - table.find elements by tag name('tr') 
self.assertIn(row text, [row.text for row in rows]) 


def test can start a list and retrieve it later(self): 


[:] 


我 喜欢 把 辅助 方法 放 在 类 的 顶部 ， 置 于 tearDown 和 第 一 个 测试 之 间 。 下 面 在 功能 测试 中 使 
用 这 个 辅助 方法 : 





functional tests.py 


# 她 按 回 车 键 后 ， 页 面 更 新 了 

# 待 办 事项 表格 中 显示 了 “1: Buy peacock feathers" 
inputbox.send keys(Keys.ENTER) 

time.sleep(1) 

self.check for row in list table('1: Buy peacock feathers') 

















# 页 面 中 又 显示 了 一 个 文本 框 ， 可 以 输入 其 他 的 待 办 事项 

# 她 输入 了 “Use peacock feathers to make a fly" (使 用 孔雀 羽毛 做 假 蝇 ) 
# 伊 迪 丝 做 事 很 有 条 理 

inputbox = self.browser.find element by id('id new item') 
inputbox.send keys('Use peacock feathers to make a fly') 
inputbox.send keys(Keys.ENTER) 




















注 1; 如 果 你 没 遇 到 过 这 个 概念 ， 我 告诉 你 ,“ 代 码 异 味 ” 表 明 一 段 代码 需要 重 写 。Jeff Atwood 在 他 的 博客 
Coding Horror 中 搜集 了 很 多 这 方面 的 资料 。 编 程 经 验 越 丰富 ， 你 的 鼻子 就 会 变 得 越 灵 敏 ， 能 够 嗅 出 
代码 中 的 异味 。 
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time.sleep(1) 














# 页 面 再 次 更 新 ， 她 的 清单 中 显示 了 这 两 个 待 办 事项 
self.check for row in list table('1: Buy peacock feathers ' ) 
self.check for row in list table('2: Use peacock feathers to make a fly') 

















# 伊 迪 丝 想 知道 这 个 网 站 是 否 会 记 住 她 的 清单 
[...] 
再 次 运行 功能 测试 ， 看 重 构 前 后 的 表现 是 否 一 致 : 


AssertionError: '1: Buy peacock feathers' not found in [ 1: Use peacock 
feathers to make a fly'] 


很 好 。 接 下 来 ， 提 交 这 次 针对 功能 测试 的 小 重 构 : 

$ git diff # 查看 functional_tests.py 中 的 改动 

$ git commit -a 
继续 开发 工作 。 如 果 要 处 理 不 止 一 个 待 办 事项 ， 需 要 某 种 持久 化 存储 ， 在 Web 应 用 领域 ， 
数据 库 是 一 种 成 熟 的 解决 方案 。 


5.5 Django ORM 和 第 一 个 模型 


对 象 关系 映射 器 (Object-Relational Mapper, ORM) 是 一 个 数据 抽象 层 ， 描 述 存 储 在 数据 
库 中 的 表 、 行 和 列 。 处 理 数 据 库 时 ， 可 以 使 用 熟悉 的 面向 对 象 方式 ， 写 出 更 好 的 代码 。 在 
ORM 的 概念 中 ， 类 对 应 数据 库 中 的 表 ， 属 性 对 应 列 ， 类 的 单个 实例 表示 数据 库 中 的 一 行 
数据 。 

Django 对 ORM 提供 了 良好 的 支持 ， 学 习 ORM 的 绝 佳 方法 是 在 单元 测试 中 使 用 它 ， 因 为 
单元 测试 能 按照 指定 方式 使 用 ORM, 


下 面 在 lists/tests.py 文件 中 新 建 一 个 类 : 
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lists/tests.py 


from lists.models import Item 


[se] 
class ItemModelTest(TestCase): 


def test_saving_and_retrieving_items(self): 
first_item = Item() 
first_item.text = 'The first (ever) list item' 
first_item.save() 


second_item = Item() 
second_item.text = 'Item the second' 
second item.save() 


saved items - Item.objects.all() 
self.assertEqual(saved items.count(), 2) 
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first saved item - saved items[0] 

second saved item - saved items[1] 
self.assertEqual(first saved item.text, 'The first (ever) list item') 
self.assertEqual(second saved item.text, 'Item the second') 


由 上 述 代 码 可 以 看 出 ， 在 数据 库 中 创建 新 记录 的 过 程 很 简单 : 先 创建 一 个 对 象 ， 再 为 一 些 属 
性 赋值 ， 然 后 调用 .save() 函数 。Django 提供 了 一 个 查询 数据 库 的 API， 即 类 属性 objects, 
再 使 用 可 能 是 最 简单 的 查询 方法 .atL()， 取 回 这 个 表 中 的 全 部 记录 。 得 到 的 结果 是 一 个 类 
似 列 表 的 对 象 ， 叫 Queryset。 从 这 个 对 象 中 可 以 提取 出 单个 对 象 ， 然 后 还 可 以 再 调用 其 他 函 
数 ， 例 如 ,count()。 接 着 ， 检 查 存储 在 数据 库 中 的 对 象 ， 看 保存 的 信息 是 否 正确 。 


Django 中 的 ORM 有 很 多 有 用 且 直 观 的 功能 。 现 在 可 能 是 略 读 Django 教程 (https:/docs. 
djangoproject.com/en/1.11/intro/tutorial01/) 的 好 时 机 ， 这 个 教程 很 好 地 介绍 了 ORM 的 功能 。 























这 个 单元 测试 写 得 很 哆 唆 ， 因 为 我 想 借 此 介绍 Django ORM。 我 不 建议 你 在 
现实 中 也 这 么 写 。 第 15 章 会 重 写 这 个 测试 ， 尽 可 能 做 到 精简 。 























术语 : 单元 测试 和 集成 测试 的 区 别 以 及 数据 库 
追求 纯粹 的 人 会 告诉 你 ， 真 正 的 单元 测试 绝 不 能 涉及 数据 库 操 作 。 我 刚 编写 的 测试 或 
许 叫 作 “ 整 合 测 试 ”(integrated test) 更 确切 ， 因 为 它 不 仅 测 试 代 码 ， 还 依赖 于 外 部 系 
统 ， 即 数据 库 。 
现在 可 以 忽略 这 种 区 别 ， 因 为 有 两 种 测试 ， 一 种 是 功能 测试 ， 从 用 户 的 角度 出 发 ， 站 
在 一 定 高 度 上 测试 应 用 ; 另 一 种 从 程序 员 的 角度 出 发 ， 做 底层 测试 。 





在 第 23 章 会 再 次 讨论 单元 测试 和 整合 测试 。 











试 着 运行 单元 测试 。 接 下 来 要 进入 另 一 次 “单元 测试 / 编写 代码 ”循环 : 


ImportError: cannot import name 'Item' 





M 


很 好 。 下 面 在 lists/models.py 中 写 入 一 些 代码 ， 让 它 有 内 容 可 导入 。 我 们 有 自信 ， 因 此 会 
跳 过 编写 Item = None 这 一 步 ， 直 接 创建 类 : 














lists/models.py 
from django.db import models 


class Item(object): 
pass 


这 些 代码 让 测试 向 前 进展 到 了 : 


first item.save() 
AttributeError: 'Item' object has no attribute 'save' 


为 了 给 Iten 类 提供 save 方法 ， 也 为 了 让 这 个 类 变 成 真正 的 Django 模型 ， 要 让 它 继承 Model 类 : 
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lists/models.py 


from django.db import models 


class Item(models.Model): 
pass 


5.5.1 第 一 个 数据 库 迁 移 
再 次 运行 测试 ， 会 看 到 一 个 数据 库 错 误 : 
django.db.utils.OperationalError: no such table: lists item 
f£ Django "^, ORM 的 任务 是 模型 化 数据 库 。 创 建 数据 库 其 实 是 由 另 一 个 系统 负责 的 ， 叫 作 
迁移 (migration)。 迁 移 的 任务 是 ， 根 据 你 对 models.py 文件 的 改动 情况 ， 添 加 或 删除 表 和 列 。 
你 可 以 把 迁移 想象 成 数据 库 使 用 的 版 本 控制 系统 。 后 面 会 看 到 ， 把 应 用 部 署 到 线 上 服务 器 
升级 数据 库 时 ， 迁 移 十 分 有 用 。 
现在 只 需要 知道 如 何 创建 第 一 个 数据 库 迁 移 一 一 使 用 makemigrations 命令 创建 迁移 : ^ 
$ python manage.py makemigrations 
Migrations for 'lists': 
lists/migrations/0001 initial.py 
- Create model Item 


$ ls lists/migrations 
0001 initial.py _ init .py  Jpycache . 


如 果 好 奇 ， 可 以 看 一 下 迁移 文件 中 的 内 容 ， 你 会 发 现 ， 这 些 内 容 表明 了 在 models.py 文件 
中 添加 的 内 容 。 


与 此 同时 ， 应 该 会 发 现 测试 又 取得 了 一 点 进展 。 


5.5.2 ”测试 向 前 走 得 挺 远 
其 实 ， 测 试 向 前 走 得 还 插 远 ， 












































$ python manage.py test lists 


self.assertEqual(first saved item.text, 'The first (ever) list item') 
AttributeError: 'Item' object has no attribute 'text' 


这 离 上 次 失败 的 位 置 整整 八 行 。 在 这 八 行 代码 中 ， 保 存 了 两 个 待 办 事项 ， 检 查 它 们 是 否 存 
入 了 数据 库 。 可 是 ，Django 似乎 不 记得 有 .text 属性 。 

如 果 你 刚 接触 Python， 可 能 会 觉得 意外 ， 为 什么 一 开始 能 给 .text 属性 赋值 呢 ? 在 Java 等 
语言 中 ， 本 应 该 得 到 一 个 编译 错误 。 但 是 Python 要 宽松 一 些 。 


继承 models. Model 的 类 映射 到 数据 库 中 的 一 个 表 。 默 认 情 况 下 ， 这 种 类 会 得 到 一 个 自动 生 
成 的 id 属 性， 作为 表 的 主键 ， 但 是 其 他 列 都 要 自行 定义 。 定 义 文本 字段 的 方法 如 下 : 















































注 2: 你 可 能 想 知 道 什么 时 候 应 该 运行 迁移 ， 什 么 时 候 应 该 创建 迁移 。 别 急 ， 后 面 会 讲 到 。 
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lists/models.py 


class Item(models.Model): 
text - models.TextField() 


Django 提供 了 很 多 其 他 字段 类 型 ， 例 如 IntegerField, CharField, DateField 等 。 使 用 TextField 
而 不 用 CharField， 是 因为 后 者 需要 限制 长 度 ， 但 是 就 目前 而 言 ， 这 个 字段 的 长 度 是 随意 的 。 
关于 字段 类 型 的 更 多 介绍 可 以 阅读 Django 教程 (https://docs.djangoproject.com/en/1.11/intro/ 
tutorial02/#creating-models) 和 文档 (https://docs.djangoproject.com/en/1.11/ref/models/fields/)。 


5.5.3 添加 新 字段 就 要 创建 新 迁移 
运行 测试 ， 会 看 到 另 一 个 数据 库 错误 : 
django.db.utils.OperationalError: no such column: lists item.text 


出 现 这 个 错误 的 原因 是 在 数据 库 中 添加 了 一 个 新 字段 ， 所 以 要 再 创建 一 个 迁移 。 测 试 能 告 
诉 我 们 这 一 点 真是 太 好 了 1 


创建 迁移 试 试 : 


$ python manage.py makemigrations 
You are trying to add a non-nullable field 'text' to item without a default; we 
can't do that (the database needs something to populate existing rows). 

Please select a fix: 

1) Provide a one-off default now (will be set on all existing rows with a null 
value for this column) 

2) Quit, and let me add a default in models.py 

Select an option:2 


个 命令 不 允许 添加 没有 默认 值 的 列 。 选 择 第 二 个 选项 ， 然 后 在 models.py 中 设 定 一 个 默 
iit. 我 想 你 会 发 现 所 用 的 句法 无 须 过 多 解释 : 















































lists/models.py 


class Item(models.Model): 
text = models.TextField(default-'') 


现在 应 该 可 以 顺利 创建 迁移 了 : 


$ python manage.py makemigrations 
Migrations for 'lists': 
lists/migrations/0002 item text.py 
- Add field text to item 


在 models.py rfi veu 了 新 代码 ， 创 建 了 两 个 数据 库 迁 移 ， 由 此 得 到 的 结果 是 ， 模 型 对 
象 上 的 .text 属性 能 被 识别 为 一 个 特殊 属性 了 ， 因 此 属性 的 值 能 保存 到 数据 库 中 ， 测 试 也 
能 通过 了 : 


$ python manage.py test lists 


EI 


























Ran 3 tests in 0.010s 
OK 





邮 





下 面 提交 创建 的 第 一 个 模型 : 


$ git status # 看 到 tests.py 和 models.py 以 及 两 个 没 跟踪 的 迁移 文件 
$ git diff # 审查 tests.py 和 modeLs.py 中 的 改动 


$ git add lists 
$ git commit -m "Model for list Items and associated migration" 


5.6 把 POST 请 求 中 的 数据 存 入 数据 库 


接 下 来 ， 要 修改 针对 首页 中 POST 请 求 的 测试 。 希望 视图 把 新 添加 的 待 办 事项 存 入 数据 
库 ， 而 不 是 直接 传 给 响应 。 为 了 测试 这 个 操作 ， 要 在 现 有 的 测试 方法 test_can_save_a_ 
POST request 中 添加 三 行 新 代码 : 
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lists/tests.py 


def test can save a POST request(self): 
response = self.client.post('/', data-('item text': 'A new list item')) 


self.assertEqual(Item.objects.count(), 1) © 
new item - Item.objects.first() 6 
self.assertEqual(new item.text, 'A new list item') 6 


self.assertIn('A new list item', response.content.decode()) 
self.assertTemplateUsed(response, 'home.html') 


@ 检查 是 否 把 一 个 新 Item 对 象 存 和 数据库 。objects.count() 是 objects.all().count() 
的 简写 形式 。 

O objects.first() 等 价 于 objects.aLL()[0]。 

@ ”检查 待 办 事项 的 文本 是 否 正确 。 

这 个 测试 变 得 有 点 儿 长 ， 看 起 来 要 测试 很 多 不 同 的 东西 。 这 也 是 一 种 代码 异味 。 长 的 单元 

测试 可 以 分 解 成 两 个 ， 或 者 表明 测试 太 复杂 。 我 们 把 这 个 问题 记 在 自己 的 待 办 事项 清单 

中 ,或 许可 以 写 在 一 张 便签 ”上 : 














e RAFA: POST 请 求 的 测试 太 长 吗 ? 


记 在 便签 上 就 不 会 忘记 。 然 后 在 合适 的 时 候 再 回来 解决 。 再 次 运行 测试 ， 会 看 到 一 个 预期 
失败 : 





























注 3: 这 张 便签 由 儿 张 图 片 合成 。 一 一 译 者 注 
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self.assertEqual(Item.objects.count(), 1) 


AssertionError: 0 !- 1 


修改 一 下 视图 : 


from django.shortcuts 
from lists.models impo 


def home page(request) 
item - Item() 
item.text - reques 
item.save() 


return render(requ 
'new item text 


D 


lists/views.py 


import render 
rt Item 


t.POST.get('item text', '') 


est, 'home.html', { 
': request.POST.get('item text', ''), 


我 使 用 的 方法 很 天 真 ， 你 或 许 能 发 现 有 一 个 明显 的 问题 : 每 次 请 求 首 页 都 保存 一 个 无 内 容 
的 待 办 事项 。 把 这 个 问题 记 在 便签 上 ， 稍 后 再 解决 。 要 知道 ， 除 了 这 个 明显 的 严重 问题 之 








外 ， 目 前 还 无 法 为 不 同 的 用 

















户 创建 不 同 的 清单 。 暂 且 忽 略 这 些 问题 。 





记 住 ， 并 不 是 说 在 实际 的 开发 中 始终 要 把 这 种 明显 的 问题 忽略 。 预 见 到 问题 时 ， 要 做 出 判 
断 ， 是 停止 正在 做 的 事 从 头 再 来 ， 还 是 暂时 不 管 ， 以 后 再 解决 。 有 时 完成 手头 的 工作 是 可 


以 接受 的 做 法 ， 但 有 些 时 候 
看 一 下 单元 测试 的 进展 如 何 





return render(requ 


问题 可 能 很 严重 ， 必 须 停 下 来 重新 思考 。 
senpag 通过 了 ， 太 好 了 ! 现在 可 以 做 些 重 构 : 





lists/views.py 
est, 'home.html', { 


'new item text': item.text 


n 


看 一 下 便签 ,我 添加 了 好 儿 件 事 : 











。 不 更 甸 次 请 求 都 保存 空白 的 待 办 事项 





eR 
“在 






mA: POST 请 求 的 测试 太 长 吗 ? 
表格 中 显示 多 个 待 办 事项 








。 支 持 多 个 清单 ! 












Un ww. 














先 看 第 一 个 问题 。 虽 然 可 以 在 现 有 的 测试 中 添加 一 个 断言 ， 但 最 好 让 单元 测试 一 次 只 测试 
一 件 事 。 那 么 ， 定 义 一 个 新 测试 方法 吧 : 











lists/tests.py 
class HomePageTest(TestCase): 


[...] 


def test only saves items when necessary(self): 
self.client.get('/') 
self.assertEqual(Item.objects.count(), 0) 


这 个 测试 得 到 的 是 1 != 9 失败 。 下 面 来 修正 这 个 问题 。 注 意 ， 虽 然 对 视图 函数 的 逻辑 改动 
幅度 很 小 ， 但 代码 的 实现 方式 有 很 多 细微 的 变动 : 





lists/views.py 


def home page(request): 
if request.method -- 'POST': 
new item text = request.POST['item text'] © 
Item.objects.create(text-new item text) 6 
else: 
new item text - '' o 


return render(request, 'home.html', { 
'new item text': new item text, ©@ 
n 
@ 使 用 一 个 名 为 new item text 的 变量 ， 甚 值 是 POST 请 求 中 的 数据 ， 或 者 是 空 字符 上 
@  .objects.create 是 创建 新 Item 对 象 的 简化 方式 ， 无 须 再 调用 .save() 方法 。 
这 样 修改 之 后 ， 测 试 就 通过 了 : 


Ran 4 tests in 0.010s 








pum 




















OK 
5.7 ”处 理 完 POST 请 求 后 重 定向 
可 是 new item text = '' 还 是 让 我 高 兴 不 起 来 。 幸 好 现在 可 以 顺带 解决 这 个 问题 。 视 图 函 




















数 有 两 个 作用 : 一 是 处 理 用 户 输入 ， 二 是 返回 适当 的 响应 。 前 者 已 经 完成 了 ， 即 把 用 户 的 
输入 保存 到 数据 库 中 。 下 面 来 看 后 者 。 

人 们 都 说 处 理 完 POST 请 求 后 一 定 要 重 定向 ， 那 么 接 下 来 就 实现 这 个 功能 吧 。 再 次 修改 
针对 保存 POST 请 求 数据 的 单元 测试 ， 不 让 它 泻 染 包含 待 办 事项 的 响应 ， 而 是 重 定向 到 
首页 : 
























































lists/tests.py 


def test can save a POST request(self): 
response = self.client.post('/', data-('item text': 'A new list item')) 
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self.assertEqual(Item.objects.count(), 1) 
new item - Item.objects.first() 
self.assertEqual(new item.text, 'A new list item') 


self.assertEqual(response.status code, 302) 
self.assertEqual(response['location'], '/') 


不 需要 再 拿 啊 应 中 的 content 属性 值 和 谊 染 模板 得 到 的 结果 比较 ， 因 此 把 相应 的 断言 删 掉 
了 。 现 在 ， 响 应 是 HTTP 重 定向 ， 状 态 码 是 302， 让 浏览 器 指向 一 个 新 地 址 。 


修改 之 后 运行 测试 ， 得 到 的 结果 是 200 != 302 错误 。 现 在 可 以 大 幅度 清理 视图 函数 了 : 






































lists/views.py(ch051028) 


from django.shortcuts import redirect, render 
from lists.models import Item 


def home page(request): 
if request.method -- 'POST': 
Item.objects.create(text-request.POST['item text']) 
return redirect('/') 


return render(request, 'home.html') 
现在 ， 测试 应 该 可 以 通过 了 : 
Ran 4 tests in 0.010s 


OK 


更 好 的 单元 测试 实践 方法 : 一 个 测试 只 测试 一 件 事 

现在 视图 函数 处 理 完 POST 请 求 后 会 重 定向 ， 这 是 习惯 做 法 ， 而 且 单 元 测试 也 一 定 程度 上 
缩短 了 ， 不 过 还 可 以 做 得 更 好 。 

良好 的 单元 测试 实践 方法 要 求 ， 一 个 测试 只 能 测试 一 件 事 。 因 为 这 样 便于 查找 问题 。 如 果 
一 个 测试 中 有 多 个 断言 ， 一 旦 前 面 的 断言 导致 测试 失败 ， 就 无 法 得 知 后 面 的 断言 情况 如 
何 。 下 一 章 会 看 到 ， 如 果 不 小 心 破坏 了 视图 函数 ， 我 们 想 知道 到 底 是 保存 对 象 时 出 错 了 ， 
还 是 响应 的 类 型 不 对 。 

刚 开 始 可 能 无 法 写 出 只 有 一 个 断言 的 完美 单元 测试 ， 不 过 现在 似乎 是 把 正在 开发 的 功能 4 
开 测 试 的 好 机 会 : 



















































































lists/tests.py 


def test can save a POST request(self): 
self.client.post('/', data-('item text': 'A new list item']) 


self.assertEqual(Item.objects.count(), 1) 
new item - Item.objects.first() 
self.assertEqual(new item.text, 'A new list item') 





def test redirects after POST(self): 
response = self.client.post('/', data-('item text': 'A new list item')) 
self.assertEqual(response.status code, 302) 
self.assertEqual(response['location'], '/') 
现在 应 该 看 到 有 五 个 测试 通过 ， 而 不 是 四 个 : 


Ran 5 tests in 0.010s 


OK 


5.8 ”在 模板 中 泻 染 待 办 事项 


感觉 好 多 了 ! 再 看 待 办 事项 清单 。 














* 4B dE E POST 请 求 的 测试 去 长 吗 ? 
。 在 表格 中 显示 多 个 待 办 事项 
。 支 持 多 个 清单 ! 























uf, tme afi P m th mm 











把 问题 从 清单 上 划 掉 几乎 和 看 着 测试 通过 一 样 让 人 满足 。 


第 三 个 问题 是 最 后 一 个 容易 解决 的 问题 。 要 编写 一 个 新 单元 测试 ， 检 查 模 板 是 否 也 能 显示 
多 个 待 办 事项 : 








lists/tests.py 
class HomePageTest(TestCase): 


[...] 


def test displays all list items(self): 
Item.objects.create(text-'itemey 1') 
Item.objects.create(text-'itemey 2') 


response = self.client.get('/') 


self.assertIn('itemey 1', response.content.decode()) 
self.assertIn('itemey 2', response.content.decode()) 
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看 到 测试 中 的 空 行 了 吗 ? 我 把 设置 测试 的 开头 两 行 放 在 一 起 ， 中 间 放 一 行 ， 
调用 要 测试 的 代码 ， 最 后 再 下 断言 。 这 不 是 强制 要 求 ， 但 是 有 助 于 分 清 阐 试 
的 结构 。 设 置 - 使 用 -断言 ， 这 是 单元 测试 的 典型 结构 。 












































这 个 测试 和 预期 一 样 会 失败 : 


AssertionError: 'itemey 1' not found in '<html>\n «head»An [...] 


Django 的 模板 句法 中 有 一 个 用 于 遍历 列表 的 标签 ， 即 {% for .. in .. €), TRE IRI 
的 方式 使 用 这 个 标签 : 





lists/templates/home.html 


«table id-"id list table" 
{% for item in items %} 
«tr»«td»1: {{ item.text }}</td></tr> 
{% endfor X) 
</table> 


eo S UR 行 对 应 items 变量 中 
一 个 元 素 。 这 么 写 很 优雅 ! 后 文 我 还 会 介绍 更 多 Django 模板 的 魔力 ， 但 总 有 一 天 你 要 
m Django 文档 ， 学 习 模 板 的 其 他 用 法 。 


只 修改 模板 还 不 能 让 测试 通过 ， 还 要 在 首页 的 视图 中 把 待 办 事项 传 入 模板 : 


























lists/views.py 


def home page(request): 
if request.method -- 'POST': 
Item.objects.create(text-request.POST['item text']) 
return redirect('/') 


items - Item.objects.all() 
return render(request, 'home.html', ['items': items}) 


这 样 单元 测试 就 能 通过 了 。 关 键 时 刻 到 了 ， 功 能 测试 能 通过 吗 ? 


$ python functional tests.py 
ee] 





AssertionError: 'To-Do' not found in 'OperationalError at /' 


很 显然 不 能 。 要 使 用 另 一 种 功能 测试 调试 技术 ， 也 是 最 直观 的 一 种 : 手动 访问 网 站 。 在 
浏览 器 中 打开 http://localhost:8000， 你 会 看 到 一 个 Django 调试 页 面 ， 提 示 “no such table: 
lists_item”( 没 有 这 个 表 : lists_item)， 如 图 5-2 所 示 。 











@ localhost:8000 "©| Bl» as 


《 


OperationalError at / 


no such table: lists item 


GET 
http://localhost:8000/ 
1.6 


OperationalError 
no such table: lists item 


/usr/local/lib/python3.3/dist-packages/django/db/backends/sqlite3/base.py in execute, 


/usr/bin/python3 
3.3.2 


['/tmp/tmpdss633/superlists', 
"/usr/Vocal/lib/python3.3/dist-packages/mock-1.8.1-py3.3.egg', 
'fusr/lib/python3.3', 

'/usr/lib/python3.3/plat-x86 64-linux-gnu', 
'J/usr/lib/python3.3/lib-dynload', 

' /home/harry/ .Local/lib/python3.3/site-packages', 
* [usr/local/lib/python3.3/dist-packages' , 
'/usr/lib/python3/dist-packages ' ] 


Server time: Wed, 13 Nov 2013 13:13:13 +0000 


Request Method: 
Request URL: 
Django Version: 
Exception Type: 
Exception Value: 
Exception Location: 
Python Executable: 
Python Version: 
Python Path: 


Error during template rendering 


In template /tsp/tmpdss633/supertists/lists/templates/home.htmt, error at line 13 


no such table: lists item 
3 





«title»To-Do listse/title» 








图 52. 又 一 个 很 有 帮助 的 调试 信息 


5.9 使 用 迁移 创建 生产 数据 库 





又 是 一 个 Django 生成 的 很 有 帮助 的 错误 消息 ， 大 意 是 说 没有 正确 设置 数据 库 。 你 可 能 会 


\ 一 X 一 


问 :“ 为 什么 在 单元 测试 中 一 切 都 运行 





良好 呢 ? ”这 是 





因为 Django 为 单元 测试 创建 了 专用 


的 测试 数据 库 一 一 这 是 Django 中 TestCase 所 做 的 神奇 事情 之 一 。 


为 了 设置 好 真正 的 数据 库 ， 要 创建 一 个 数据 库 。SQLite 数据 库 只 是 硬盘 中 的 一 个 文件 。 你 


会 在 Django 











的 settings.py 文件 中 发 现 ， 默 认 情 况 下 ，Django 把 数据 库 保存 为 db.sqlite3， 


放 在 项 目的 基 目 录 中 : 
superlists/settings.py 
Es 
# Database 
# https://docs.djangoproject.com/en/1.11/ref/settings/#databases 


DATABASES = { 
'default': { 


'ENGINE': 'django.db.backends.sqlite3', 
'NAME': os.path.join(BASE DIR, 'db.sqlite3'), 
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我 们 已 经 在 models.py 文件 和 后 来 创建 的 迁移 文件 中 告诉 Django 创建 数据 库 所 需 的 一 切 信 
息 ， 为 了 创建 真正 的 数据 库 ， 要 使 用 Django 中 另 一 个 强大 的 manage.py 命令 一 一 migrate: 


$ python manage.py migrate 
Operations to perform: 
Apply all migrations: admin, auth, contenttypes, lists, sessions 
Running migrations: 
Applying contenttypes.0001 initial... OK 
Applying auth.0001 initial... OK 
Applying admin.0001 initial... OK 
Applying admin.0002 logentry remove auto add... OK 
Applying contenttypes.0002 remove content type name... OK 
Applying auth.0002 alter permission name max length... OK 
Applying auth.0003 alter user email max length... OK 
Applying auth.0004 alter user username opts... OK 
Applying auth.0005 alter user last login null... OK 
Applying auth.0006 require contenttypes 0002... OK 
Applying auth.0007 alter validators add error messages... OK 
Applying auth.0008 alter user username max length... OK 
Applying lists.0001 initial... OK 
Applying lists.0002 item text... OK 
Applying sessions.0001 initial... OK 


现在 ， 可 以 刷新 localhost 上 的 页 面 了 ， 你 会 发 现 错误 页 面 不 见 了 “。 然 后 再 运行 功能 测试 
WIN: 
AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Buy 
peacock feathers', '1: Use peacock feathers to make a fly'] 


快 成 功 了 ， 只 需要 让 清单 显示 正确 的 序号 即 可 。 另 一 个 出 色 的 Django 模板 标签 forloop. 
counter 能 帮忙 解决 这 个 问题 





























lists/templates/home.html 


{% for item in items X) 
<tr><td>{{ forloop.counter }}: {{ item.text }}</td></tr> 
{% endfor %} 


再 试 一 次 ， 应 该 会 看 到 功能 测试 运行 到 最 后 了 : 


self.fail('Finish the test!') 
AssertionError: Finish the test! 


不 过 运行 测试 时 ， 你 可 能 会 注意 到 有 什么 地 方 不 对 劲 ， 如 图 5-3 所 示 。 




















注 4: 如 果 你 看 到 了 另 一 个 错误 页 面 ， 重 启 开发 服务 器 试 试 。Django 可 能 被 发 生 在 眼皮 子 底下 的 事情 搞 糊 涂 了 。 















































To-Do lists - Mozilla Firefox x 
$ à B- ox 


$° |€ localhost 8000 v @| | 图 v Google Q 


Firefox« |£3To-Dolists +| 


Your To-Do list 








Enter a to-do item 


1: Buy peacock feathers 
2: Use peacock feathers to make a fly 
3: Buy peacock feathers 
4: Use peacock feathers to make a fly 








~v x 8 © 











85-3: 有 上 一 次 运行 测试 时 遗留 下 来 的 待 办 事项 


我 ， 天 呐 。 看 起 来 上 一 次 运行 测试 时 在 数据 库 中 遗留 了 数据 。 如 有 果 再 次 运行 测试 ， 会 发 现 
待 办 事项 又 多 了 : 

Buy peacock feathers 

Use peacock feathers to make a fly 

Buy peacock feathers 

Use peacock feathers to make a fly 


Buy peacock feathers 
Use peacock feathers to make a fly 


啊 ， 离 成 功 就 差 一 点 点 了 。 需 要 一 种 自动 清理 机 制 。 你 可 以 手动 清理 ， 方 法 是 先 删除 数据 
库 再 执行 migrate 命令 新 建 : 


$ rm db.sqlite3 
$ python manage.py migrate --noinput 


清理 之 后 要 确保 功能 测试 仍 能 通过 

除了 功能 测试 中 这 个 小 问题 之 外 ， 我 们 的 代码 基本 上 都 可 以 正常 运行 了 。 下 面 做 一 次 提 
交 吧 。 

先 执行 git status， 再 执行 git diff， 你 应 该 会 看 到 对 home.html、tests.py 和 views.py 所 
做 的 改动 。 然 后 提交 这 些 改动 : 


$ git add lists 
$ git commit -m "Redirect after POST, and show all items in template" 























NA 和 上 WwWwP 请 
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你 可 能 会 觉得 在 每 一 章 结束 时 做 个 标记 很 有 用 ， 例 如 在 本 章 结 束 时 可 以 这 么 
做 : git tag end-of-chapter-05。 





5.10 回顾 

这 一 章 我 们 做 了 什么 呢 ? 

编写 了 一 个 表单 ， 使 用 POST 请 求 把 新 待 办 事项 添加 到 清单 中 。 

创建 了 一 个 简单 的 数据 库 模型 ， 用 来 存储 待 办 事项 。 

。 学 习 了 如 何 创建 数据 库 迁 移 , 既 针 对 测试 数据 库 (自动 运行 ), 也 针对 真实 的 数据 库 CF 
动 运 行 )。 

。 用 到 了 两 个 Django 模板 标签 : {% csrf token %} 和 {% for ... endfor %} 循环 。 

。 至 少 用 到 了 三 种 功能 测试 调试 技术 : 行 间 print 语句 、time.sleep 以 及 改进 错误 消息 。 

但 待 办 事项 清单 中 还 有 两 件 事 没 做 ， 其 中 一 项 是 “功能 测试 运行 完毕 后 清理 战场 *， 还 有 

一 项 或 许 更 紧急 一 一 “支持 多 个 清单 ”。 




















S e edd ERROR HAR 
<o 。 RHA POSTEE AHA d Ee S- 
K 。 功 能 测试 运行 之 后 清理 战场 

S 。 支 持 多 个 清单 ! 














我 想 说 的 是 ， 虽 然 网 站 现在 这 个 样子 可 以 发 布 ， 但 用 户 可 能 会 觉得 奇怪 : 为 什么 所 有 人 要 
共用 一 个 待 办 事项 清单 。 我 想 这 会 让 人 们 停 下 来 思考 一 些 问题 : 我 们 彼此 之 间 有 怎样 的 联 
A? 在 地 球 这 艘 宇宙 飞船 上 有 着 怎样 的 共同 命运 ?要 如 何 团结 起 来 解决 共同 面 对 的 全 球 性 
问题 ? 

可 实际 上 ， 这 个 网 站 还 没什么 用 。 

先 这 样 吧 。 





























有 用 的 TDD 概念 
回归 
新 添加 的 代码 破坏 了 应 用 原本 可 以 正常 使 用 的 功能 。 
意外 失败 
测试 在 意料 之 外 失败 了 。 这 意味 着 测试 中 有 错误 ， 或 者 测试 帮 我 们 发 现 了 一 个 回 
归 ， 因 此 要 在 代码 中 修正 。 
遇 红 / 变 绿 / 重 构 
描述 TDD 流程 的 另 一 种 方式 。 先 编写 一 个 测试 看 着 它 失 败 ( 遇 红 )， 然 后 编写 代码 
让 测试 通过 ( 变 绿 ) ， 最 后 重 构 ， 改 进 实 现 方式 。 
三 角 法 
添加 一 个 测试 ， 专 门 为 某 些 现 有 的 代码 编写 用 例 ， 以 此 推断 出 普 适 的 实现 方式 (在 
此 之 前 的 实现 方式 可 能 作 产 了 ) 。 
事 不 过 三 , 三 则 重 构 
判断 何 时 删除 重复 代码 时 使 用 的 经 验 法 则 。 如 果 两 段 代码 很 相似 ， 往 往 还 要 等 到 第 
三 段 相似 代码 出 现 ， 才 能 确定 重 构 时 哪 一 部 分 是 真正 共通 、 可 重用 的 。 
记 在 便签 上 的 待 办 事项 清单 
在 便签 上 记录 编写 代码 过 程 中 遇 到 的 问题 ， 等 手头 的 工作 完成 后 再 回 过 头 来 解决 。 
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第 6 章 
PEZ Bed: 确保 隔 高 ， 
去 挥 含糊 的 休眠 

















在 深入 分 析 和 解决 真正 的 问题 之 前 ， 先 来 做 些 清理 工作 。 前 一 章 末尾 指出 ， 两 次 运行 的 测 
试 之 间 会 彼此 影响 ， 那 就 来 修正 这 个 问题 吧 。 此 外 ， 我 对 代码 中 多 次 出 现 的 time.sleep 也 
不 满意 ， 这 样 做 似乎 有 点 不 科学 ， 我 们 将 采用 更 可 靠 的 方式 实现 。 
































。 功能 测试 运行 之 后 清理 战场 
。 去 掉 time.sleep 











这 两 项 改动 都 向 着 测试 “最 佳 实践 ”迈进 ， 能 让 测试 更 确定 、 更 可 靠 。 


senh i EE 
6.1 确保 功能 测试 之 间 相 互 隔 离 
前 一 童 结束 时 留 下 了 一 个 典型 的 测试 问题 ， 如 何 隔 离 测 试 。 运 行 功 能 测试 后 待 办 事项 一 直 
存在 于 数据 库 中 ， 这 会 影响 下 次 测试 的 结果 。 
运行 单元 测试 时 ，Django 的 测试 运行 程序 会 自动 创建 一 个 全 新 的 测试 数据 库 (和 应 用 真正 
使 用 的 数据 库 不 同 )， 运 行 每 个 测试 之 前 都 会 清空 数据 库 ， 等 所 有 测试 都 运行 完 之 后 ， 再 
删除 这 个 数据 库 。 但 是 功能 测试 目前 使 用 的 是 应 用 真正 使 用 的 数据 库 db.sqlite3。 
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这 个 问题 的 解决 方法 之 一 是 自己 动手 ， 在 functional tests.py 中 添加 执行 清理 任务 的 代码 。 
这 样 的 任务 最 适合 在 setUp 和 tearDown 方法 中 完成 。 














不 过 从 1.4 版 开始 ，Django 提供 的 一 个 新 类 LiveServerTestCase 可 以 代 我 们 完成 这 一 任 
务 。 这 个 类 会 自动 创建 一 个 测试 数据 库 ( 跟 单 元 测试 一 样 )， 并 启动 一 个 开发 服务 器 ， 让 
功能 测试 在 其 中 和 运行。 虽然 这 个 工具 有 一 定局 限 性 〈 稍 后 解决 )， 不 过 在 现 阶段 十 分 有 用 。 
看 学 习 如 何 使 用 。 


LiveServerTestCase 必须 使 用 manage.py， 由 Django 的 测试 运行 程序 运行 。 从 Django 1.6 
F 始 ， 测 试 运 行程 序 查找 所 有 名 字 以 test 开头 的 文件 。 为 了 保持 文件 结构 清晰 ， 要 新 建 一 
个 文件 夹 保存 功能 测试 ， 让 它 看 起 来 就 像 一 个 应 用 。Django 对 这 个 文件 夹 的 要 求 只 有 一 
个 一 一 必须 是 有 效 的 Python 模块 ， 即 文件 夹 中 要 有 一 个 init. py 文件 。 


$ mkdir functional_tests 
$ touch functional tests/. init, .py 














才 











H 











然后 要 移动 功能 测试 ， 把 独立 的 functional_tests.py 文件 移 到 functional tests 应 用 中 ， 并 
把 它 重 命名 为 tests.py。 使 用 git mv 命令 完成 这 个 操作 ， 让 Git 知道 文件 移动 了 : 


$ git mv functional tests.py functional tests/tests.py 
$ git status # WE functional tests/tests.py, iH Ep T. init .py 


现在 的 目录 结果 如 下 所 示 : 

















l— db.sqLite3 

HF functional tests 

L— | init .py 

L— tests.py 

|— lists 

I— admin.py 

|— apps.py 

m | init .py 

[— migrations 
I— 60001 initial.py 
HF 0002 item text.py 
L— init .py 
L—  pycache . 

HF models.py 

FF 一 pycache . 

[— templates 

L— home.html 

| 一 tests.py 

—— views.py 

|l— manage.py 

L— superlists 
L— init .py 
| 一 | pycache . 

[— settings.py 

m urls.py 

—— wsgi.py 











functional tests.py 不 见 了 ， 变 成 了 functional tests/tests.py。 现 在 ， 运 行 功能 测试 不 执行 python 
functional tests.py 命令 ， 而 是 使 用 python manage.py test functional tests 命令 。 
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功能 测试 可 以 和 lists 应 用 测试 混在 一 起 ， 不 过 我 喜欢 把 两 种 测试 分 开 ， 因 
为 功能 测试 检测 的 功能 往往 存在 于 不 同 应 用 中 。 功 能 测试 以 用 户 的 视角 看 待 
事物 ， 而 用 户 并 不 关心 你 如 何 把 网 站 分 成 不 同 的 应 用 。 














接 下 来 编辑 functional tests/tests.py， 修 改 NewVisitorTest 类 ， 让 它 使 用 LiveServerTestCase: 


functional tests/tests.py (ch061001) 


from django.test import LiveServerTestCase 

from selenium import webdriver 

from selenium.webdriver.common.keys import Keys 
import time 


class NewVisitorTest(LiveServerTestCase): 


def setUp(self): 
[ss] 


往 下 修改 。 访 问 网 站 时 ， 不 用 硬 编 码 的 本 地 地 址 (localhost:8000)， 可 以 使 用 


LiveServerTestCase 提供 的 live server url 属性 : 


functional tests/tests.py (ch061002) 


def test can start a list and retrieve it later(self): 
# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 竺 办 事项 应 用 
# 她 去 看 了 这 个 应 用 的 首页 


self.browser.get(self.live server url) 




















还 可 以 删除 文件 末尾 的 if ^ name == ' main ' 代码 块 ， 因 为 之 后 都 使 用 Django 的 测 
试 运 行程 序 运行 功能 测试 。 

现在 能 使 用 Django 的 测试 运行 程序 运行 功能 测试 了 ， 指 明 只 运行 functional_tests 应 用 
中 的 测试 : 














$ python manage.py test functional tests 
Creating test database for alias 'default'... 


FAIL: test can start a list and retrieve it later 
(functional tests.tests.NewVisitorTest) 
Traceback (most recent call last): 
File "/.../superlists/functional tests/tests.py", line 65, in 
test can start a list and retrieve it later 
self.fail('Finish the test!') 
AssertionError: Finish the test! 


Ran 1 test in 6.578s 


FAILED (failures-1) 
System check identified no issues (0 silenced). 
Destroying test database for alias 'default'... 











功能 测试 和 重 构 前 一 样 ， 能 运行 到 self.fail。 如 果 再 次 运行 测试 ， 你 会 发 现 ， 之 前 的 测 
试 不 再 遗留 待 办 事项 了 ， 因 为 功能 测试 运行 完 之 后 把 它们 清理 掉 了 。 成 功 了 ， 现 在 应 该 提 
交 这 次 小 改动 : 

$ git status # 重 命名 并 修改 了 functionalL_tests.py， 新 增 了 _init_ .py 

$ git add functional tests 

$ git diff --staged -M 

$ git commit # 提交 消息 举例 : "make functional tests an app, use LiveServerTestCase" 
git diff 命令 中 的 -M 标 志 很 用， 意思 是 “检测 移动 "， 所 以 git 会 注意 到 functional. tests.py 
和 functional_tests/tests.py 是 同一 个 文件 ， 显 示 更 合理 的 差异 (去掉 这 个 旗 标 试 试 )。 


《运行 单元 测试 
现在 ， 如 果 执 行 manage.py test 命令 ，Django 会 运行 功能 测试 和 单元 测试 


$ python manage.py test 
Creating test database for alias 'default'... 














FAIL: test can start a list and retrieve it later 


DON 


AssertionError: Finish the test! 


Ran 7 tests in 6.732s 


FAILED (failures=1) 


如 果 只 想 运 行 单元 测试 ， 可 以 指定 只 运行 ists 应 用 中 的 测试 


$ python manage.py test lists 
Creating test database for alias 'default'... 











Ran 6 tests in 0.009s 


OK 
System check identified no issues (0 silenced). 
Destroying test database for alias 'default'... 





有 用 的 命令 〈 更 新 版 ) 
。 运行 功能 测试 
python manage.py test functional, tests 
。 运行 单元 测试 
python manage.py test lists 
如 果 我 说 “运行 测试 "， 而 你 不 确定 我 指 的 是 哪 一 种 测试 怎么 办 ? 可 以 回顾 一 下 第 4 章 


最 后 一 节 中 的 流程 图 ， 试 着 找 出 我 们 处 在 哪 一 步 。 通 常 只 在 所 有 单元 测试 都 通过 后 才 
会 运行 功能 测试 。 如 果 不 清楚 ， 两 种 测试 都 运行 试 试 吧 | 
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6.2 升级 Selenium 和 Geckodriver 

今天 再 次 检查 这 一 章 时 ， 我 发 现 功能 测试 停 在 那里 不 动 了 。 

后 来 我 才 发 现 ， 是 因为 Firefox 在 夜里 自动 更 新 了 ， 而 Selenium 和 Geckodriver 也 要 随 之 升 
级 。Geckodriver 的 发 布 页 面 也 证 实 确实 有 新 版 发 布 了 。 所 以 ， 我 们 要 按照 下 述 步骤 进行 下 
载 和 升级 。 

。 执行 pip install --upgrade selenium 命令 。 

。 下 载 新 版 Geckodriver。 

。 备份 旧版 ， 放 在 某 处 ， 把 新 版 放 在 PATH 中 的 某 个 位 置 。 

e 执行 geckodriver --version 命令 ， 确 认 新 版 是 否 可 用 。 

升级 之 后 ， 功 能 测试 又 能 按 预期 运行 了 。 

在 此 处 讲解 这 个 问题 没有 特殊 的 原因 。 当 你 阅读 到 这 里 时 也 不 一 定 会 遇 到 这 个 问题 ， 但 是 
你 总 会 遇 到 的 。 再 加 上 我 们 又 在 做 清理 工作 ， 所 以 我 觉得 现在 是 最 适合 的 时 机 。 

这 是 使 用 Selenium 时 你 必须 忍受 的 一 件 事 。 虽 然 可 以 固定 所 用 的 浏览 器 和 Selenium 版 本 
(例如 在 CI 服务 器 上 ) ， 但 是 现实 中 的 浏览 器 是 不 断 进化 的 ， 你 要 跟 上 用 户 的 步伐 。 






































只 要 发 现 功能 测试 遇 到 奇怪 的 问题 ， 就 可 以 升级 Selenium 试 试 。 


回 到 常规 的 编程 上 来 。 


6.3 ” 隐 式 等 待 、 显 式 等 待 和 含糊 的 time.sleep 
来 看 看 功能 测试 中 的 time. sleep: 


functional tests/tests.py 


# 她 按 回 车 键 后 ， 页 面 更 新 了 

# 待 办 事项 清单 中 显示 了 “1: Buy peacock feathers” 
inputbox.send keys(Keys.ENTER) 

time.sleep(1) 








self.check for row in list table('1: Buy peacock feathers') 


这 叫 “ 显 式 等 待 "， 与 之 相对 的 是 “ 隐 式 等 待 ” : 某 些 情况 下 ， 当 Selenium 认为 页 面 正 在 
加 载 时 ， 它 会 “自动 ”等 待 一 会 儿 。 如 果 要 在 页 面 中 查找 的 元 素 尚 未 出 现 ， 还 可 以 使 用 
Selenium 提供 的 implicitly wait 方法 指明 要 等 多 久 。 
其 实 本 书 第 1 版 完全 依赖 隐 式 等 待 。 但 是 ， 隐 式 等 待 有 点 奇怪 ， 而 且 从 Selenium 3 开始 ， 
隐 式 等 待 变 得 极度 不 可 靠 。 此 外 ，Selenium 团队 普遍 认为 隐 式 等 待 不 是 个 好 主意 ， 应 该 避 
免 使 用 。 















































因此 ， 第 2 版 从 一 开始 就 使 用 显 式 等 待 。 但 问题 是 ，time.steep 自身 也 有 问题 。 我 们 现 





在 等 待 了 1 秒 ,但 谁 又 能 说 这 是 合理 的 时 间 呢 ?对 于 在 自己 的 设备 上 运行 的 多 数 测试 来 








说 ，1 秒 太 长 了 ， 严 重 拖 慢 了 功能 测试 ， 等 待 0.1 秒 就 行 了 。 但 问题 是 ， 如 果真 等 待 这 么 
短 的 时 间 ， 常 常会 导致 测试 假 失 败 一 一 因为 在 某 些 情况 下 ， 笔 记 本 电脑 的 速度 可 能 稍 慢 一 


些 

















。 话 说 回来 ， 即 便 等 待 了 1 秒 ， 也 无 法 绝对 避免 不 是 由 真正 的 问题 导致 的 失败 。 测 试 


中 的 假 阳性 确实 烦人 (关于 这 一 话题 的 详细 讨论 参见 Martin Fowler 写 的 一 篇 文章 ， 名 为 


“Eradicating Non-Determinism in Tests" ) , 








如 果 遇 到 意料 之 外 的 NoSuchElementException 和 StaleElementException 错 
误 ， 通 常 就 表明 没有 显 式 等 待 。 去 掉 tine.sleep 试 试看 会 不 会 出 现 这 样 的 
错误 。 




















下 面 调整 休眠 的 实现 方式 ， 让 测试 等 待 足够 长 的 时 间 ， 以 便 捕 获 可 能 出 现 的 问题 。 我 们 将 
check for row in list table 重 命 名 为 wait_for_row_in_List_tabLe， 并 添加 一 些 轮 询 / 重 
试 逻辑 : 


© © © © 


functional tests/tests.py (ch061004) 


from selenium.common.exceptions import WebDriverException 


MAX WAIT = 10 Q 
[...] 


def wait for row in list table(self, row text): 
start time - time.time() 
while True: 6 
try: 
table = self.browser.find element by id('id list table') ©@ 
rows - table.find elements by tag name('tr') 
self.assertIn(row text, [row.text for row in rows]) 
return OQ 
except (AssertionError, WebDriverException) as e: G9 
if time.time() - start time » MAX WAIT: Q 
raise e Q 
time.sleep(0.5) © 


通过 MAX. WAIT 常量 设 定 准备 等 待 的 最 长 时 间 。10 FAE ARTERS eA T 
预知 的 缓慢 因素 了 。 

这 个 循环 一 直 运 行 ， 直 到 遇 到 两 个 出 口中 的 一 个 为 止 。 

这 个 三 行 断言 跟 这 个 方法 的 旧版 一 样 。 

如 有 果 能 顺利 运行 而 且 断 言 通过 了 ， 就 退出 函数 、 跳 出 循环 。 


但 如 果 捕 获 到 了 异常 ， 就 再 等 一 小 段 时 间 ， 然 后 重新 循环 。 我 们 要 捕获 两 种 异常 : 一 
种 是 WebDriverException， 在 页 面 未 加 载 或 Selenium 未 在 页 面 上 找到 表格 元 素 时 抛 
出 ， 另 一 种 是 AssertionError， 因 为 页 面 中 虽 有 表格 ,但 它 可 能 在 页 面 重新 加 载 之 前 
就 存在 ， 里 面 还 是 没有 我 们 要 找 的 行 。 
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@ 这 是 第 二 个 出 口 。 如 果 执 行 到 这 里 ， 说 明代 码 不 断 抛 出 异常 ， 已 经 超时 。 因 此 这 里 再 
次 抛 出 异常 ， 向 上 冒 泡 ， 最 终 可 能 出 现在 调用 跟踪 中 ， 指 明 测 试 失败 的 原因 。 

是 不 是 觉得 这 段 代码 有 点 灼 脚 、 有 点 不 明 所 以 ?我 同意 。 后 文 会 做 重 构 ， 定 义 一 个 通用 的 

wait for 辅助 方法 ， 把 计时 、 重 新 抛 出 异常 的 逻辑 与 测试 断言 分 开 。 不 过 ， 这 要 等 到 需要 

在 多 个 地 方 使 用 它 时 再 做 。 




















如 果 你 以 前 用 过 Selenium， 可 能 知道 它 提供 了 一 些 用 于 等 待 的 辅助 函数 。 我 
不 太 喜 欢 使 用 这 些 函数 。 本 书 将 构建 几 个 用 于 等 待 的 辅助 工具 ， 我 觉得 这 样 
能 让 代码 更 优雅 、 更 易于 阅读 。 不 过 ， 你 绝对 应 该 学 习 一 下 Selenium 自 带 的 
那些 辅助 函数 ， 然 后 判断 要 不 要 使 用 。 


下 调用 新 的 方法 ， 并 把 含糊 的 tine.sleep 去 掉 : 




















下 











functional tests/tests.py (ch061005) 


Lissa] 

# 她 按 回 车 键 后 ， 页 面 更 新 了 

# 待 办 事项 清单 中 显示 了 “1: Buy peacock feathers" 
inputbox.send keys(Keys.ENTER) 
self.wait for row in list table('1: Buy peacock feathers') 














# 页 面 中 还 有 一 个 文本 框 ， 可 以 输入 其 他 的 待 办 事项 

# 她 输入 了 “Use peacock feathers to make a fly" (使 用 孔 汰 羽毛 做 假 蝇 ) 
# 伊 迪 丝 做 事 很 有 条 理 

inputbox = self.browser.find element by id('id new item') 
inputbox.send keys('Use peacock feathers to make a fly') 
inputbox.send keys(Keys.ENTER) 



































# 页 面 再 次 更 新 ， 清 单 中 显示 了 这 两 个 待 办 事项 
self.wait for row in list table('2: Use peacock feathers to make a fly') 
self.wait for row in list table('1: Buy peacock feathers') 


[...] 
然后 再 次 运行 测试 : 


$ python manage.py test 
Creating test database for alias 'default'... 














FAIL: test can start a list and retrieve it later 
(functional tests.tests.NewVisitorTest) 
Traceback (most recent call last): 
File "/.../superlists/functional tests/tests.py", line 73, in 
test can start a list and retrieve it later 
self.fail('Finish the test!') 
AssertionError: Finish the test! 





Ran 7 tests in 4.552s 


FAILED (failures-1) 
System check identified no issues (0 silenced). 
Destroying test database for alias 'default'... 


结果 跟 之 前 一 样 ， 不 过 测试 的 执行 时 间 比 之 前 短 了 几 秒 。 虽 然 现 在 只 快 了 一 点 ， 但 是 随 着 
测试 的 增多 ， 速 度 优势 便 会 慢 慢 显 现 。 

A quer 下 面 将 故意 破坏 测试 ， 看 看 会 出 现 什 么 错误 。 首 先 看 一 下 能 
检测 永远 不 会 出 现在 一 行 里 的 文本 : 








functional tests/tests.py (ch061006) 


rows - table.find elements by tag name('tr') 
self.assertIn('foo', [row.text for row in rows]) 
return 


我 们 将 看 到 一 个 意思 明确 的 测试 失败 消息 : 


self.assertIn('foo', [row.text for row in rows]) 
AssertionError: 'foo' not found in ['1: Buy peacock feathers'] 


改 回 去 ， 然 后 再 破坏 其 他 地 方 : 


functional tests/tests.py (ch061007) 


try: 
table = self.browser.find element by id('id nothing!) 
rows - table.find elements by tag name('tr') 
self.assertIn(row text, [row.text for row in rows]) 
return 


Esi 
显然 ， 得 到 的 错误 指明 页 面 中 没有 要 查找 的 元 素 : 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: [id-"id nothing"] 


看 起 来 一 切 正常 。 改 回 原样 ， 最 后 再 运行 测试 确认 一 下 : 


$ python manage.py test 























[5] 
AssertionError: Finish the test! 
很 好 。 短 暂 离 题 ， 下 面 回 到 正轨 ， 说 明 如 何 实现 多 个 清单 。 





























本 章 运 用 的 测试 “最 佳 实 践 ” 
。 确保 测试 隔离 ， 管 理 全 局 状态 
不 同 的 测试 之 间 不 能 彼此 影响 ， 也 就 是 说 每 次 测试 结束 后 都 要 还 原 永 久 状 态 
Django ep dd d 帮助 我 们 创建 测试 数据 库 ， 这 个 数据 库 在 每 次 测试 名 bk 
后 都 会 清空 (详情 请 参见 第 23 3), 
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。 避免 使 用 “含糊 的 ”休眠 
一 旦 需要 等 待 什么 加 载 ， 我 们 的 第 一 反应 便 是 使 用 time.sleep。 但 是 这 样 做 带 来 的 
问题 是 ， 时 间 的 长 度 是 两 眼 一 抹黑 : 要 么 太 短 ， 容 易 导 致 假 失败 ; RAKK, 4 
慢 测试 。 我 推荐 使 用 重 试 循环 ， 它 可 以 轮 询 应 用 ,尽早 向 前 行进 。 





。 不 要 依赖 Selenium 的 隐 式 等 待 
Selenium 确实 有 理论 上 的 “ 隐 式 ”等 待 ， 但 是 在 不 同 浏览 器 上 的 实现 各 不 相同 。 而 
且 在 写作 本 书 时 ， 隐 式 等 待 在 Selenium 3 的 Firefox 驱动 上 极度 不 可 靠 。Python 之 
FM: AT ETER, BEOUÉXYE X ASCRdWN,. 











第 7 章 








现在 就 来 解决 当前 存在 的 问题 。 目 前 ， 我 们 的 设计 只 允许 创建 一 个 全 局 清单 。 这 一 章 将 说 
一 个 关键 的 TDD 技术 : 如 何 使 用 递增 的 步 进 式 方法 修改 现 有 代码 ， 而 且 保 证 代码 在 修 
改 前 后 都 能 正常 运行 。 我 们 要 做 测试 山羊 ， 而 不 是 重 构 猫 。 


7.1 必要 时 做 少量 的 设计 


请 想 一 想 应 该 如 何 支持 多 个 清单 。 目 前 的 功能 测试 〈 与 设计 文档 最 接近 ) 是 这 样 的 : 








functional tests/tests.py 


# 伊 迪 丝 想 知道 这 个 网 站 是 否 会 记 住 她 的 清单 
# 她 看 到 网 站 为 她 生成 了 一 个 唯一 的 URL 

# 页 面 中 有 一 些 解说 这 个 功能 的 文字 
self.fail('Finish the test!') 








# 她 访问 那个 URL， 发 现 待 办 事项 清单 还 在 
# 她 很 满意 ， 去 睡觉 了 


不 过 ， 我 们 要 在 此 基础 上 扩展 一 下 ， 让 用 户 不 能 相互 查看 各 自 的 清单 ， 而 且 每 个 用 户 都 有 
自己 的 URL， 能 访问 自己 的 清单 。 怎 么 实现 这 样 的 设计 呢 ? 


7.1.1 不 要 预先 做 大 量 设计 

TDD 和 软件 开发 中 的 敏捷 运动 联系 紧密 。 敏 捷 运动 反对 传统 软件 工程 实践 中 预先 做 大 量 设 
计 的 做 法 ， 因 为 除了 要 花费 大 量 时 间 收 集 需 求 之 外 ， 设 计 阶 段 还 要 用 等 量 的 时 间 在 纸 上 规 
划 软 件 。 敏 捷 理 念 则 认为 ， 在 实践 中 解决 问题 比 理论 分 析 能 学 到 更 多 ， 而 且 让 应 用 尽早 接 
受 真实 用 户 的 检验 效果 更 好 。 无 须 花 这 么 多 时 间 提 前 设计 ， 而 要 尽早 把 最 简 可 用 的 应 用 放 
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出 来 ， 根 据 实际 使 用 中 得 到 的 反馈 逐步 向 前 推进 设计 。 

这 并 不 是 说 要 完全 禁止 思考 设计 。 前 一 章 我 们 看 到 ， 不 经 思考 呆 头 呆 脑 往 前 走 ， 最 终 也 能 

找到 正确 答案 ， 不 过 稍微 思考 一 下 设计 往往 能 帮助 我 们 更 快 地 找到 答案 。 那 么 ， 下 面 分 析 

一 下 这 个 最 简 可 用 的 应 用 ， 想 想 应 该 使 用 哪 种 设计 方式 。 

。 想 让 每 个 用 户 都 能 保存 自己 的 清单 ， 目 前 来 说 ， 至 少 能 保存 一 个 清单 。 

。 清单 由 多 个 待 办 事项 组 成 ， 待 办 事项 的 主要 属性 应 该 是 一 些 描述 性 文字 。 

。 要 保存 清单 , 以 便 多 次 访问 。 现 在 ,可 以 为 用 户 提供 一 个 唯一 的 URL, 指向 他 们 的 清单 。 
以 后 或 许 需要 一 种 自动 识别 用 户 的 机 制 ， 然 后 把 他 们 的 清单 显示 出 来 。 

为 了 实现 第 一 条 ， 看 样子 要 把 清单 和 其 中 的 待 办 事项 存 和 人 数据库。 每 个 清单 都 有 一 个 唯一 

的 URL， 而 且 清单 中 的 每 个 待 办 事项 都 是 一 些 描述 性 文字 ， 和 所 在 的 清单 关联 。 


7.1.2 YAGNI 

关于 设计 的 思考 一 旦 开始 就 很 难 停 下 来 ， 我 们 会 冒 出 各 种 想法 : 或 许 想 给 每 个 清单 起 个 
名 字 或 加 个 标题 ， 或 许 想 使 用 用 户 名 和 密码 识别 用 户 ， 或 许 想 给 清单 添加 一 个 较 长 的 备 
注 和 简短 的 描述 ， 或 许 想 存储 某 种 顺序 ， 等 等 。 但 是 ， 要 遵守 敏捷 理念 的 另 一 个 信条 
“YAGNI”( 读 作 yag-knee)。 它 是 “You ain't gonna need it”( 你 不 需要 这 个 ) 的 简称 。 作 
为 软件 开发 者 ， 我 们 从 创造 事物 中 获得 乐趣 。 有 时 我 们 冒 出 一 个 想法 ， 觉 得 可 能 需要 ， 便 
无 法 抵御 内 心 的 冲动 想 要 开发 出 来 。 可 问题 是 ， 不 管 想 法 有 多 好 ， 大 多 数 情况 下 最 终 你 都 
用 不 到 这 个 功能 。 应 用 中 会 残留 很 多 没 用 的 代码 ， 还 增加 了 应 用 的 复杂 度 。YAGNI 是 个 
真言 ， 可 以 用 来 抵御 热切 的 创造 欲 。 


7.1.3 REST ( 式 ) 
我 们 已 经 知道 怎么 处 理 数 据 结构 ， 即 使 用 “模型 - 视图 -控制 器 ”中 的 模型 部 分 。 那 视 
和 控制 器 部 分 怎么 办 呢 ? 在 Web 浏览 器 中 用 户 怎么 处 理 清 单 和 待 办 事项 呢 ? 
“表现 层 状 态 转化 ” (representational state transfer, REST) 是 Web 设计 的 一 种 方式 ， 经 常 
用 来 引导 基于 Web 的 API 设计 。 设 计 面 向 用 户 的 网 站 时 ， 不 必 严 格 遵守 REST 规则 ， 可 
是 从 中 能 得 到 一 些 启发 。( 如 果 想 看 看 真实 的 REST API 是 什么 样子 ， 可 以 跳 到 附录 F。) 
REST 建议 URL 结构 匹配 数据 结构 ， 即 这 个 应 用 中 的 清单 和 其 中 的 待 办 事项 。 清 单 有 各 自 的 URL: 
/lists/<list identifier>/ 
这 个 URL 满足 了 功能 测试 中 提出 的 需求 。 若 想 查看 某 个 清单 ， 我 们 可 以 发 送 一 个 GET 请 
求 (就 是 在 普通 的 浏览 器 中 访问 这 个 页 面 )。 
若 想 创建 全 新 的 清单 ， 可 以 向 一 个 特殊 的 URL 发 送 POST 请 求 : 
/lists/new 
若 想 在 现 有 的 清单 中 添加 一 个 新 待 办 事项 ， 我 们 可 以 向 另外 一 个 URL 发 送 POST 请 求 : 


[/lists/«list identifier>/add_item 


再 次 说 明 ， 我 们 不 会 严格 遵守 REST 规则 ， 只 是 从 中 得 到 启发 。 比 如， 按照 REST 规则 ， 
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这 里 应 该 使 用 PUT 请 求 ， 但 是 标准 的 HTML 表单 无 法 发 送 PUT 请 求 。) 
概括 起 来 ， 本 章 的 便签 如 下 所 示 : 








。 调 整 模型 ， 让 待 办 事项 和 不 同 的 清单 关联 起 来 

。 为 委 个 清单 添加 唯一 的 URL 

。 添 加 通过 POST 请 求 新 建 清单 所 需 的 URL 

。 添 加 通过 POST 请 求 在 现 什 的 清单 中 增加 新 待 办 事项 所 需 的 URL 





























7.2 ”使 用 TDD 实 现 新 设计 
应 该 如 何 使 用 TDD 实现 新 的 设计 呢 ? 再 回顾 一 下 TDD 的 流程 图 ， 如 图 7-1 所 示 。 








编写 单元 测试 应 用 是 否 


需要 重 构 ? 


编写 最 少量 的 代码 


图 7-1: 包含 功能 测试 和 单元 测试 的 TDD 流程 
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在 流程 的 外 层 ， 既 要 添加 新 功能 (添加 新 的 功能 测试 ， di E 

应 用 的 代码 ， 即 重 写 部 分 现 有 的 实现 ， 保持 应 用 的 功能 ， 但 使 用 新 的 设计 方式 。 我 们 
通过 现 有 的 功能 测试 确保 不 破坏 现 有 的 功能 ， 同 时 通 vie 测试 驱动 开发 新 功能 。 

s um i eI 

用 来 保证 这 个 过 程 没有 破坏 现 有 的 功能 


7.3 确保 出 现 回归 测 试 
下 面 根据 便签 上 的 待 办 事项 编写 一 个 新 的 功能 测试 方法 ， 引 入 第 二 个 用 户 ， 并 确认 他 的 竺 
办 事项 清单 与 仇 迪 丝 的 清单 是 分 开 的 。 


这 个 功能 测试 的 开头 与 第 一 个 功能 测试 基本 一 样 一 一 伊 迪 丝 提交 第 一 个 待 办 事项 后 ， 应 用 创 
建 一 个 新 清单 。 不 过 这 次 要 多 添加 一 个 断言 ， 确 认 伊 迪 丝 的 清单 是 独立 的 ， 有 唯一 的 URL: 
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functional tests/tests.py (ch071005) 


def test can start a list for one user(self): 
# 伊 迪 丝 听 说 有 一 个 很 酷 的 在 线 待 办 事项 应 用 
# 她 去 看 了 这 个 应 用 的 首页 
[村 
# 页 面 再 次 更 新 ， 她 的 清单 中 显示 了 这 两 个 待 办 事项 
self.wait for row in list table('2: Use peacock feathers to make a fly') 
self.wait for row in list table('1: Buy peacock feathers') 















































# 她 很 满意 ， 然 后 去 睡觉 了 





def test multiple users can start lists at different urls(self): 
# 伊 迪 丝 新 建 一 个 待 办 事项 清单 
self.browser.get(self.live server url) 
inputbox = self.browser.find element by id('id new item') 
inputbox.send keys('Buy peacock feathers') 
inputbox.send keys(Keys.ENTER) 
self.wait for row in list table('1: Buy peacock feathers') 












































# 她 注意 到 清单 有 个 唯一 的 URL 
edith list url = self.browser.current url 
self.assertRegex(edith list url, '/lists/.4') © 


Q  assertRegex 是 unittest 提供 的 辅助 函数 ， 用 于 检查 字符 串 是 否 匹 配 正则 表达 式 。 我 
们 利用 它 检查 新 的 REST 式 设 计 能 否 实现 。 详 情 请 参见 unittest 的 文档 。 


然后 ， 我 们 假设 有 一 个 新 用 户 正在 访问 网 站 。 当 新 用 户 访问 首页 时 ， 要 测试 他 不 能 看 到 伊 
迪 丝 的 待 办 事项 ， 而 且 他 的 清单 有 自己 的 唯一 URL: 












































functional tests/tests.py (ch071006) 
[21 


self.assertRegex(edith list url, '/lists/.-') 





# 现在 一 名 叫 作 弗朗西斯 的 新 用 户 访问 了 网 站 


a 我 们 使 用 一 个 新 浏览 器 会 话 。@ 

1 确保 伊 迪 丝 的 信息 不 会 从 cookie 中 泄露 出 去 
self.browser.quit() 

self.browser = webdriver.Firefox() 





# 弗朗西斯 访问 首页 

# 页 面 中 看 不 到 伊 迪 丝 的 清单 
self.browser.get(self.live server url) 

page text - self.browser.find element by tag name('body').text 
self.assertNotIn('Buy peacock feathers', page text) 
self.assertNotIn('make a fly', page text) 


# 弗朗西斯 输入 一 个 新 待 办 事项 ， 新 建 一 个 清单 
# 他 不 像 伊 迪 丝 那样 兴趣 僵 然 

inputbox = self.browser.find element by id('id new item') 
inputbox.send keys('Buy milk') 

inputbox.send keys(Keys.ENTER) 
self.wait for row in list table('1: Buy milk') 

















# 弗朗西斯 获得 了 他 的 唯一 URL 

francis list url = self.browser.current url 
self.assertRegex(francis list url, '/lists/.-«') 
self.assertNotEqual(francis list url, edith list url) 











# 这 个 页 面 还 是 没有 伊 迪 丝 的 清 

page text = self.browser.find element by tag name('body').text 
self.assertNotIn('Buy peacock feathers', page text) 
self.assertIn('Buy milk', page text) 


# 两 人 都 很 满意 ， 然 后 去 睡觉 了 
@ 按照 习惯 ， 我 使 用 两 个 # 表示 “元 注释 ”。 元 注释 的 作用 是 说 明 测 试 的 工作 方式 以 及 
为 什么 这 么 做 。 使 用 两 个 井 号 是 为 了 和 功能 测试 中 解说 用 户 故事 的 常规 注释 区 分 开 。 
这 个 元 注释 是 发 给 未 来 自己 的 消息 ， 如 果 没 有 这 条 消息 ， 到 时 你 可 能 会 觉得 奇怪 ， 想 
知道 到 底 为 什么 要 退出 浏览 器 再 启动 一 个 新 会 话 。 
除了 元 注释 之 外 ， 就 不 需要 对 这 个 新 测试 多 做 解释 了 。 看 一 下 运行 功能 测试 后 的 情况 
如 何 : 


$ python manage.py test functional tests 


[4.5] 























FAIL: test multiple users can start lists at different urls 
(functional tests.tests.NewVisitorTest) 
Traceback (most recent call last): 
File "/.../superlists/functional tests/tests.py", line 83, in 
test multiple users can start lists at different urls 
self.assertRegex(edith list url, '/lists/.-') 
AssertionError: Regex didn't match: '/lists/.+' not found in 
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'http://localhost:8081/' 


Ran 2 tests in 5.786s 
FAILED (failures-1) 


很 好 ， 第 一 个 测试 仍 能 通过 ， 而 第 二 个 测试 也 如 我 们 所 料 失 败 了 。 先 提交 一 次 ， 然 后 再 编 
写 一 些 新 模型 和 新 视图 : 


$ git commit -a 


7.4 逐步 和 迭代， 实现 新 设计 

我 太 兴 备 了 ， 人 迫切 地 想 实 现 新 设计 ， 这 种 欲望 太 强 烈 ， 谁 也 无 法 阻拦 ， 我 真 想 现在 就 开 
始 修改 models.py。 但 这 么 做 可 能 会 导致 一 半 的 单元 测试 失败 ， 我 们 不 得 不 一 行 一 行 修改 
人 代码， 而且 要 一 次 改 完 ， 工 作 量 太 大 。 有 这 样 的 冲动 很 自然 ， 但 TDD 理念 一 直 反 对 这 么 
做 。 我 们 要 遵从 测试 山羊 的 教诲 ， 不 能 听信 重 构 猪 的 旗 言 。 无 须 一 次 性 实现 光鲜 亮丽 的 
整个 设计 ， 改 动 的 幅度 要 小 一 些 ， 每 一 步 都 要 遵照 设计 思想 的 指引 ， 保 证 修改 后 应 用 仍 
能 正常 运行 。 

在 待 办 事项 清单 中 还 有 四 个 问题 没 解决 。 无 法 匹配 正则 表达 式 的 那个 功能 测试 提醒 我 们 ， 
接 下 来 要 解决 的 是 第 二 个 问题 ， 即 为 每 个 清单 添加 唯一 的 URL 和 标识 符 。 下 面 解决 且 只 
解决 这 个 问题 。 



































清单 的 URL 出 现在 重 定向 POST 请 求 之 后 。 在 文件 lists/tests.py 中 ， 找 到 test redirects | 
after_P0ST， 修 改 重 定向 期 望 转 问 的 地 址 : 





lists/tests.py 


self.assertEqual(response.status code, 302) 
self.assertEqual(response['location'], '/lists/the-only-list-in-the-world/') 


这 个 URL 看 起 来 是 不 是 有 点 儿 奇 怪 ? 在 应 用 的 最 终 设计 中 显然 不 会 使 用 /lists/the-only-listin- 
the-world/ 这 个 URL。 可 是 我 们 承诺 过 ， 一 次 只 做 一 项 改动 ， 既 然 应 用 现在 只 支持 一 个 清单 ， 
那 这 就 是 唯一 合理 的 URL。 我 们 还 在 向 前 进 ， 到 时 候 清 单 和 首页 的 地 址 都 会 变 ， 这 是 更 符合 
REST 式 设计 的 一 个 实现 步骤 。 稍 后 我 们 会 支持 多 个 清单 ， 也 会 提供 简单 的 方法 修改 URL, 

















我 们 可 以 换 种 想法 ， 把 这 看 成 是 一 种 解决 问题 的 技术 : 新 的 URL 设计 还 没 
实现 ， 所 以 这 个 URL 可 用 于 没有 待 办 事项 的 清单 。 最 终 要 设法 解决 包含 7 
个 待 办 事项 的 清单 ， 不 过 解决 包含 一 个 待 办 事项 的 清单 是 个 好 的 开始 。 















































运行 单元 济 试 ， 会 看 到 一 个 预期 失败 : 


$ python manage.py test lists 


[55] 
AssertionError: '/' !- '/lists/the-only-list-in-the-world/' 
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可 以 修改 文件 lists/views.py 中 的 home page 视 





FR 








lists/views.py 


def home page(request): 
if request.method -- 'POST': 
Item.objects.create(text-request.POST['item text']) 
return redirect('/lists/the-only-list-in-the-world/') 


items - Item.objects.all() 
return render(request, 'home.html', ['items': items]) 


这 么 修改 ， 功 能 测试 显然 会 失败 ， 因 为 网 站 中 并 没有 这 个 URL。 毫 无 疑问 ， 如 果 运 行 功能 





nt 


测试 ， 你 会 看 到 测试 在 尝试 提交 第 一 个 待 办 
出 现 这 个 错误 的 原因 是 ，/the-only-list-in-the-world/ 这 个 URL 还 不 存在 。 
File "/.../superlists/functional tests/tests.py", line 57, in 


test can start a list for one user 


[od 














selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 


element: [id-"id list table"] 
[...] 


File "/.../superlists/functional tests/tests.py", line 79, in 
test multiple users can start lists at different urls 
self.wait for row in list table('1: Buy peacock feathers') 


fos 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 


element: [id-"id list table"] 





不 仅 新 添加 的 测试 失败 了 ， 原 来 那个 也 失败 了 。 这 表明 出 现 了 回归 。 接 下 来 就 为 这 个 











的 清单 提供 一 个 URL， 重 回 正常 状态 。 


7.5 上 自 成 一 体 的 第 一 步 : 新 的 URL 














事项 后 失败 ， 提 示 无 法 找到 显示 清单 的 表格 。 





唯 














打开 lists/tests.py， 添 加 一 个 新 测试 类 ， 命 名 为 ListViewTest, RO us HomePageTest 类 
中 的 test displays all list items 方法 复制 到 这 个 新 类 中 。 给 这 个 方法 重新 命名 ， 再 





做 些 修改 : 


lists/tests.py (ch071009) 


class ListViewTest(TestCase): 


def test displays all items(self): 
Item.objects.create(text-'itemey 1') 
Item.objects.create(text-'itemey 2') 


response = self.client.get('/lists/the-only-list-in-the-world/') 
self.assertContains(response, 'itemey 1' 
self.assertContains(response, 'itemey 


)0 
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@ 这 里 用 到 一 个 新 的 辅助 方法 : 现在 不 必 再 使 用 有 点 儿 烦 人 的 assertIn 和 response. 
content.decode() Y, Django 提供 了 assertContains 方法 ， 它 知道 如 何 处 理 响 应 以 及 
响应 内 容 中 的 字 节 。 


运行 这 个 测试 ， 看 看 情况 : 


self.assertContains(response, 'itemey 1') 


Las 


AssertionError: 404 !- 200 : Couldn't retrieve content: Response code was 404 


这 是 使 用 assertContains 的 附加 好 处 它 直 接 指出 测试 失败 的 原因 是 新 URL 不 存在 ， 
而 且 返 回 的 是 404 响应 。 

















7.5.1 一 个 新 URL 
现在 那个 唯一 的 清单 URL 还 不 存在 ， 要 在 superlists/urls.py 中 解决 这 个 问题 。 








mm 


留意 URL 末尾 的 斜 线 ， 在 测试 中 和 urls.py 中 都 要 小 心 ， 因 为 这 个 斜 线 往生 
就 是 问题 的 根源 。 





super lists/urls.py 


urlpatterns - [ 
url(r'^$', views.home page, name-'home'), 
url(r'^lists/the-only-list-in-the-world/S$', views.view list, name-'view list'), 


] 
再 次 运行 测试 ， 得 到 的 结果 如 下 : 


AttributeError: module 'lists.views' has no attribute 'view list' 


7.5.2 ”一 个 新 视图 函数 
这 个 结果 无 须 过 多 解说 。 下 面 在 lists/views.py 中 定义 一 个 新 视图 函数 : 





























lists/views.py 


def view list(request): 
pass 


现在 测试 的 结果 变 成 了 : 


ValueError: The view lists.views.view list didn't return an HttpResponse 
object. It returned None instead. 

















[ical 
FAILED (errors=1) 


失败 的 只 有 一 个 了 ， 而 且 为 我 们 指明 了 方向 。 把 home page 视图 的 最 后 两 行 复制 过 来 ， 看 
能 否 骗 过 测试 : 
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lists/views.py 


def view list(request): 
items - Item.objects.all() 
return render(request, 'home.html', ['items': items]) 


再 次 运行 单元 测试 ， 测 试 应 该 能 通过 了 : 


Ran 7 tests in 0.016s 
OK 


再 运行 功能 测试 ， 看 看 情况 如 何 : 


FAIL: test can start a list for one user 


[5] 
File "/.../superlists/functional tests/tests.py", line 67, in 
test can start a list for one user 





AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Buy 
peacock feathers'] 


FAIL: test multiple users can start lists at different urls 

[s] 

AssertionError: 'Buy peacock feathers' unexpectedly found in 'Your To-Do 
listAn1: Buy peacock feathers' 


[...] 


两 个 功能 测试 都 有 一 点 进展 ， 不 过 依然 失败 了 。 我 们 要 尽快 重 回 正常 状态 ， 让 第 一 个 功能 
测试 再 次 通过 。 失 败 消息 中 有 什么 线索 呢 ? 


可 以 看 出 ， 失 败 发 生 在 尝试 添加 第 二 个 待 办 事项 时 一 一 看 来 得 调试 一 番 了 。 我 们 知道 首 
是 正常 的 ， 因 为 功能 测试 能 执行 到 第 67 行 ， 也 就 是 至 少 添加 了 一 个 待 办 事项 。 而 且 ， 
元 测试 都 能 通过 ， 因 此 可 以 确定 URL 和 视图 能 正常 运作 一 一 首页 使 用 正确 的 模板 显示 、 
能 处 理 POST 请 求 ，only-list-in-the-world 视图 知道 如 何 显示 所 有 待 办 事项 …… 但 是 它 不 知 
道 怎 样 处 理 POST 请 求 。 啊 ， 这 就 是 线索 。 


根据 经 验 ， 第 二 个 线索 是 ， 当 所 有 单元 测试 都 能 通过 而 功能 测试 不 能 通过 时 ， 问 题 
由 单元 测试 没有 禾 盖 的 事物 引起 的 一 一 这 往往 是 模板 的 问题 


最 终 我 们 找到 了 问题 的 根源 :home.html 中 的 输入 表单 没有 明确 指定 POST 的 目标 URL, 


lists/templates/home.html 























Le 





























<form method="POST"> 


默认 情况 下 ， 浏 览 器 把 POST 数据 发 回 表 单 当 前 所 在 的 URL。 这 样 的 话 ， 在 首页 能 正常 运 
行 ， 但 到 only-list-in-the-world 页 面 就 不 行 了 。 
找到 根源 后 ， 我 们 本 可 以 为 新 视图 添加 处 理 POST 请 求 的 功能 ， 但 是 这 样 还 得 编写 一 堆 测 
试 和 代码 ， 而 我 们 的 目的 是 尽早 重 回 正常 状态 。 其 实 ， 修 正 这 个 问题 最 快 i 2 
现在 能 正常 运行 的 首页 视图 处 理 所 有 POST 请 求 : 



















































































lists/templates/home.html 


«form method="POST" actionz"/"» 
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再 次 运行 测试 ， 你 会 发 现 功 能 测试 回 到 之 前 的 状态 了 : 
FAIL: test multiple users can start lists at different urls 


[34] 
AssertionError: 'Buy peacock feathers' unexpectedly found in 'Your To-Do 
list\n1: Buy peacock feathers' 





Ran 2 tests in 8.541s 
FAILED (failures-1) 


原先 的 测试 再 次 通过 ， 由 此 可 以 确认 我 们 又 回 到 了 正常 状态 。 新 功能 也 许 还 不 可 用 ， 但 至 
少 旧 的 功能 依旧 正常 。 


zi "Z 
7.6 RTB? 该 重 构 了 
该 清理 一 下 测试 了 。 
在 遇 红 / 变 绿 / 重 构 流 程 中 ， 已 经 走 到 “ 变 绿 ” 这 一 步 ， 接 下 来 该 重 构 了 。 现 在 我 们 有 两 
个 视图 ， 一 个 用 于 首页 ， 一 个 用 于 单个 清单 。 目 前 ， 这 两 个 视图 共用 一 个 模板 ， 而 且 传人 
了 数据 库 中 的 所 有 竺 办事 项。 如 果 仔 细 查 看 单元 测试 中 的 方法 ， 或 许 会 发 现 某 些 部 分 需要 
修改 ; 
$ grep -E "class|def" lists/tests.py 
class HomePageTest(TestCase): 
def test uses home template(self): 
def test displays all list items(self): 
def test can save a POST request(self): 
def test redirects after POST(self): 
def test only saves items when necessary(self): 
class ListViewTest(TestCase): 
def test displays all items(self): 
class ItemModelTest(TestCase): 
def test saving and retrieving items(self): 


完全 可 以 把 HomePageTest 中 的 test displays all list items 方法 删除 ， 因 为 不 需要 了 
如 果 现 在 执行 manage.py test lists 命令 ， 应 该 会 看 到 运行 了 6 个 测试 ， 而 不 是 7 个 : 


Ran 6 tests in 0.016s 
OK 


而 且 ， 首 页 模板 其 实 不 用 再 显示 所 有 的 待 办 事项 ， 而 应 该 只 显示 一 个 输入 框 让 用 户 新 建 
清单 。 


7.7， 再 迈 一 小 步 ， 一 个 新 模板 ， 用 于 查看 清 


既然 首页 和 清单 视图 是 不 同 的 页 面 ， 它 们 就 应 该 使 用 不 同 的 HTML. 模板 。home.html 可 以 
只 包含 一 个 输入 框 ， 新 模板 list.html 则 在 表格 中 显示 现 有 的 待 办 事项 。 


下 面 添 加 一 个 新 测试 ， 检 查 是 否 使 用 了 不 同 的 模板 : 































































































lists/tests.py 


class ListViewTest(TestCase): 


def test uses list template(self): 
response = self.client.get('/lists/the-only-list-in-the-world/') 
self.assertTemplateUsed(response, 'list.html') 


def test displays all items(self): 
[255.] 


assertTemplateUsed 是 Django 测试 客户 端 提 供 的 强大 方法 之 一 。 看 一 下 测试 的 结果 如 何 : 


AssertionError: False is not true : Template 'list.html' was not a template 
used to render the response. Actual template(s) used: home.html 


很 好 ! 然后 修改 视图 : 

















lists/views.py 


def view list(request): 
items - Item.objects.all() 
return render(request, 'list.html', ['items': items]) 


不 过 很 显然 ， 这 个 模板 还 不 存在 。 如 果 运 行 单元 测试 ， 会 得 到 如 下 结果 : 


django.template.exceptions.TemplateDoesNotExist: list.html 











新 建 一 个 文件 ， 保 存 为 lists/templates/list.html: 
$ touch lists/templates/list.html 

x^ BEBO ZEB, UA ERA TRAR, RAI SA TERANA: 
AssertionError: False is not true : Couldn't find 'itemey 1' in response 

单个 清单 的 模板 会 用 到 目前 home.html 中 的 很 多 代码 ， 所 以 可 以 先 把 其 中 的 内 容 复制 过 来 : 
$ cp lists/templates/home.html lists/templates/list.html 

这 会 让 测试 再 次 通过 ( 变 绿 )。 现 在 要 做 一 些 清理 工作 ( 重 构 )。 我 们 说 过 ， 首 页 不 用 显示 


竺 办事 项， 只 ; 和 
的 一 些 代 码 ， 或 许 还 可 以 把 h1 改 成 “Start a new To-Do list" 



















































































lists/templates/home.html 


«body» 
«hi»Start a new To-Do list«/hi» 
«form method-"POST"» 
«input name-"item text" id-"id new item" placeholder-"Enter a to-do item" /> 
{% csrf token X) 
</form> 
</body> 


再 次 运行 测试 ， 确 认 这 次 改动 没有 破坏 任何 功能 。 很 好 ， 继 续 清 理 。 
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其 实 也 不 用 在 hone. page 视图 中 把 全 部 待 办 事项 都 传人 home.html 模板 ， 因 此 可 以 把 
home page 视图 简化 成 : 








lists/views.py 


def home page(request): 
if request.method -- 'POST': 
Item.objects.create(text-request.POST['item text']) 
return redirect('/lists/the-only-list-in-the-world/') 
return render(request, 'home.html') 


再 次 运行 单元 测试 ， 它 们 仍然 能 通过 。 然 后 运行 功能 测试 ; 
AssertionError: '1: Buy milk' not found in ['1: Buy peacock feathers', '2: Buy 
milk'] 
不 错 ， 回 归 测 试 (第 一 个 功能 测试 ) 通过 了 ， 而 且 新 增 的 测试 稍微 向 前 进展 了 一 点 
以 指出 弗朗西斯 没有 得 到 自己 的 清单 页 面 (因为 他 仍 能 看 到 伊 迪 丝 的 部 分 待 办 事项 ) 。 
你 可 能 觉得 并 没有 取得 太 多 进展 ， 因 为 网 站 的 功能 和 本 章 开始 时 几乎 一 模 一 样 。 其 实 有 进 
展 ， 我 们 正在 实现 新 设计 ， 在 前 进 的 道路 上 铺 好 了 儿 块 垫 脚 石 ， 而 且 网 站 的 功能 几乎 没 
变 。 提 交 目 前 取得 的 进展 : 
$ git status # 会 看 到 4 个 改动 的 文件 和 1 个 新 文件 List.html 
$ git add lists/templates/list.html 
$ git diff # 会 看 到 我 们 简化 了 home.html 
# 把 一 个 测试 移 到 了 Lists/tests.py 中 的 新 类 里 
# 在 views .py 中 添加 了 一 个 新 视图 
# 还 简化 了 home_page 视 图 ， 并 在 urls.py 中 增加 了 一 个 映射 


$ git commit -a # 编写 一 个 消息 概述 以 上 操作 ,或 许可 以 写成 
# “new URL, view and template to display lists” 


7.8 第 三 小 步 : 用 于 添加 待 办 事项 的 URL 


看 一 下 待 办 事项 清单 ， 现 在 到 哪 一 步 了 呢 ? 








可 

































































。 调 整 模 型 ， 让 待 办 事项 和 不 同 的 清单 关联 起 来 





。 为 香 个 清单 添加 叭 一 的 URL 
。 添 加 通过 POST 请 求 新 建 清单 所 需 的 URL 
。 添 加 通过 POST 请 求 在 现 有 的 清单 中 增加 新 待 办 事项 所 需 的 URL 




















第 二 个 问题 已 经 取得 了 一 定 进展 ， 不 过 网 站 中 还 是 只 有 一 个 清单 。 第 一 个 问题 有 点 吓人 。 
我 们 能 对 第 三 或 第 四 个 问题 做 些 什么 呢 ? 


下 面 添 加 一 个 新 URL， 用 于 新 建 待 办 事项 。 这 么 做 至 少 能 简化 首页 视 

















S 
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7.8.4 用 来 测试 新 建 清 单 的 测试 类 
打开 文件 lists/tests.py， 把 test can save a POST request 和 test redirects after POST 两 
个 方法 移 到 一 个 新 类 中 ， 然 后 再 修改 POST 请 求 的 目标 URL: 





lists/tests.py (ch071021-1) 


class NewListTest(TestCase): 


def test can save a POST request(self): 
self.client.post('/lists/new', data-('item text': 'A new list item']) 
self.assertEqual(Item.objects.count(), 1) 
new item - Item.objects.first() 
self.assertEqual(new item.text, 'A new list item') 


def test redirects after POST(self): 
response = self.client.post('/lists/new', data-('item text': 'A new list item']) 
self.assertEqual(response.status code, 302) 
self.assertEqual(response['location'], '/lists/the-only-list-in-the-world/') 


顺便 说 一 句 ， 这 里 也 要 注意 末尾 的 斜 线 一 /new 后面 不 加 和 斜 线 。 我 的 习惯 是 ， 


不 在 修改 数据 库 的 “操作 ”后 加 斜 线 。 








顺便 学 习 一 个 新 的 Django 测试 客户 端 方法 assertRedirects: 





lists/tests.py (ch071021-2) 


def test redirects after POST(self): 
response = self.client.post('/lists/new', data-('item text': 'A new list item']) 
self.assertRedirects(response, '/lists/the-only-list-in-the-world/') 


这 个 方法 没什么 大 用 ， 不 过 能 把 两 个 断言 精简 成 一 个 。 
运行 这 个 测试 试 试 : 


self.assertEqual(Item.objects.count(), 1) 


AssertionError: 0 !- 1 
[sss] 
self.assertRedirects(response, '/lists/the-only-list-in-the-world/') 
[xe] 
AssertionError: 404 !- 302 : Response didn't redirect as expected: Response 


code was 404 (expected 302) 


第 一 个 失败 消息 告诉 我 们 ， 新 建 的 待 办 事项 没有 存 入 数据库。 第 二 个 失败 消息 指出 视图 返 
回 的 状态 码 是 404， 而 不 是 表示 重 定 向 的 302。 这 是 因为 还 没 把 /lists/new 添加 到 URL 映射 
中 ， 所 以 client.post 得 到 的 是 “not found” (未 找到 ) 响应 。 


还 记得 之 前 我 们 是 如 何 把 这 种 测试 分 成 两 个 测试 方法 的 吗 ? 如 果 在 一 个 测试 
方法 中 同时 测试 保存 数据 和 重 定向 ， 看 到 的 失败 消息 就 是 9 != 1， 调 试 起 来 
更 难 。 如 果 你 好 奇 我 是 怎么 知道 要 这 么 做 的 ， 不 要 犹 光 ， 问 我 吧 。 
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7.8. ”用 于 新 建 清单 的 URL 和 视图 
下 面 添加 新 的 URL 映射 : 


superlists/urls.py 


urlpatterns = [ 
url(r'^$', views.home page, name-'home'), 
url(r'^lists/newS', views.new list, name-'new list'), 
url(r'^lists/the-only-list-in-the-world/$', views.view list, namez'view list'), 


] 


再 运行 测试 ， 会 得 到 no attribute'new list' 错误 。 修 正 这 个 问题 ， 在 文件 lists/views.py 中 
1 A: 


lists/views.py (ch071023-1) 


def new list(request): 
pass 


再 运行 测试 ， 得 到 的 失败 消息 是 :“The view lists.views.new list didn't return an HttpResponse 
object" (lists.views.new list 视图 没 返 回 HttpResponse 对 象 )。 这 个 消息 很 眼熟 。 虽 然 可 
以 返回 一 个 原始 的 HttpResponse 对 象 ， 但 既然 知道 需要 的 是 重 定 向 ， 那 就 从 home_page 视 
中 借用 一 行 代 码 吧 : 



































lists/views.py (ch071023-2) 


def new list(request): 
return redirect('/lists/the-only-list-in-the-world/') 


现在 测试 的 结果 是 : 


self.assertEqual(Item.objects.count(), 1) 
AssertionError: 0 != 1 


失败 消息 简洁 易 懂 。 再 从 home page 视 























| 








中 借用 一 行 代码 : 





lists/views.py (ch071023-3) 


def new list(request): 
Item.objects.create(text-request.POST['item text']) 
return redirect('/lists/the-only-list-in-the-world/') 


加 入 这 行 代码 后 ， 测 试 便 能 通过 了 : 


Ran 7 tests in 0.030s 


OK 
而 且 功 能 测试 表明 ， 我 们 又 回 到 了 正常 状态 ; 
[2s] 
AssertionError: '1: Buy milk' not found in ['1: Buy peacock feathers', '2: Buy 
milk'] 


Ran 2 tests in 8.972s 
FAILED (failures-1) 





7.8.3 删除 当前 多 余 的 代码 和 测试 


看 起 来 不 错 。 既 然 新 视图 完成 了 以 前 home page 视图 的 大 部 分 工作 ， 应 该 就 可 以 大 幅度 精 
简 home page f, 比如 说 ， 可 以 删除 整个 if request.method == 'POST' 部 分 吗 ? 











lists/views.py 


def home page(request): 
return render(request, 'home.html') 


当然 可 以 ! 


OK 


既然 已 经 动手 简化 了 ， 还 可 以 把 当前 多 余 的 测试 方法 test_only_saves_items_when_necessary 
也 删 掉 。 


删 掉 之 后 是 不 是 感觉 挺 好 的 ? 视图 函数 变 得 更 简洁 了 。 再 次 运行 测试 ， 确 认 一 切 正常 : 


Ran 6 tests in 0.016s 























OK 

那 功 能 测试 呢 ? 

7.8.4 出 现 回归 ! 让 表单 指向 刚 添加 的 新 URL 
ERROR: test can start a list for one user 
[...] 


File "/.../superlists/functional tests/tests.py", line 57, in 
test can start a list for one user 
self.wait for row in list table('1: Buy peacock feathers') 
File "/.../superlists/functional tests/tests.py", line 23, in 
wait for row in list table 
table = self.browser.find element by id('id list table') 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: [id-"id list table"] 


ERROR: test multiple users can start lists at different urls 

[ss] 

File "/.../superlists/functional_tests/tests.py", line 79, in 

test_multiple_users_can_start_lists_at_different_urls 
self.wait_for_row_in_list_table('1: Buy peacock feathers') 

selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 

element: [id-"id list table"] 


[23] 


Ran 2 tests in 11.592s 
FAILED (errors-2) 


这 是 因为 表单 依然 指向 旧 的 URL。 在 home.html 和 lists.html 中 ， 把 表单 改 成 : 











lists/templates/home.html, lists/templates/list.html 


«form method="POST" action="/lists/new"> 
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这 样 就 能 回 到 之 前 的 状态 了 : 
AssertionError: '1: Buy milk' not found in ['1: Buy peacock feathers', '2: Buy 
milk'] 
Ersal 
FAILED (failures=1) 
以 上 操作 可 以 作为 一 次 完整 的 提交 : 对 URL 映射 做 了 些 改动 ，views.py 看 起 来 也 精简 多 
了 ， 而 且 能 保证 应 用 还 能 像 以 前 那样 正常 运行 。 我 们 的 重 构 技术 变 得 越 来 越 好 了 1 
$ git status # 5 个 改动 的 文件 
$ git diff # 在 两 个 表单 中 添加 了 URL， 视 图 和 测试 都 有 代码 移动 ， 还 添加 了 一 个 新 URL 


$ git commit -a 


可 以 在 待 办 事项 清单 中 划 掉 一 个 问题 了 : 












































。 调 整 模 型 ， 让 待 办 事项 和 不 同 的 清单 关联 起 来 
。 为 委 个 清单 添加 叭 一 的 URL 
。- 话 加 通过 POST 请 求 新 建 清单 所 宕 的 URE 





。 添 加 通过 POST 请 求 在 现 什 的 清单 中 增加 新 待 办 事项 所 需 的 URL 

















7.9 下 定 决心 ， 调 整 模型 


XT URL 的 清理 工作 做 得 够 多 了 ， 现 在 下 定 决心 修改 模型 。 先 调整 模型 的 单元 测试 。 这 
次 换 种 方式 ， 以 差异 的 形式 表示 改动 的 地 方 : 





lists/tests.py 


@@ -1,5 +1,5 @@ 

from django.test import TestCase 
-from lists.models import Item 

*from lists.models import Item, List 


class HomePageTest(TestCase): 
QQ -44,22 «44,32 QQ class ListViewTest(TestCase): 


-class ItemModelTest(TestCase): 
*class ListAndItemModelsTest(TestCase): 


def test saving and retrieving items(self): 





o0 | $7 


* list - List() 


* list .save() 
" 

first item - Item() 

first item.text - 'The first (ever) list item' 
* first item.list = list. 


first item.save() 


second item - Item() 

second item.text - 'Item the second' 
* second item.list = list. 

second item.save() 


* saved list - List.objects.first() 
* self.assertEqual(saved list, list ) 
4 
saved items - Item.objects.all() 
self.assertEqual(saved items.count(), 2) 
first saved item - saved items[0] 
second saved item - saved items[1] 
self.assertEqual(first saved item.text, 'The first (ever) list item') 
* self.assertEqual(first saved item.list, list ) 
self.assertEqual(second saved item.text, 'Item the second') 
* self.assertEqual(second saved item.list, list ) 





新 建 了 一 个 List 对 象 ， 然 后 通过 给 list 属性 赋值 把 两 个 待 办 事项 归 在 这 个 对 象 名 下 。 要 
检查 这 个 清单 是 否 正确 保存 ， 也 要 检查 是 否 保存 了 那 两 个 待 办 事项 与 清单 之 间 的 关系 。 你 
还 会 注意 到 可 以 直接 比较 两 个 清单 (saved list 和 list) 一 一 其 实 比 较 的 是 两 个 清单 的 
主键 (id 属性 ) 是 否 相 同 。 











我 使 用 变量 名 st. 的 目的 是 防止 遮盖 Python 原生 的 list 函数 。 这 么 写 可 
能 不 美观 ， 但 我 能 想到 的 其 他 写法 也 同样 不 美观 ， 或 者 更 糟 ， 比 如 ny list, 


the_list, list1 和 listey 等 。 



































现在 要 开始 另 一 个 “单元 测试 /编写 代码 ”循环 了 。 
在 前 儿 次 迭代 中 ， 我 只 给 出 每 次 运行 测试 时 期 望 看 到 的 错误 消息 ， 不 会 告诉 你 运行 测试 前 
要 输入 哪些 代码 ， 你 要 自己 编写 每 次 所 需 的 最 少 代码 改动 。 








需要 提示 ? 翻 回 第 5 章 ， 参 照 引 和 Item 模型 的 步骤 。 





你 首先 看 到 的 错误 消息 是 : 


ImportError: cannot import name 'List' 
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解决 这 个 错误 后 ， 再 次 运行 测试 会 看 到 ; 
AttributeError: 'List' object has no attribute 'save' 
然后 会 看 到 : 


django.db.utils.OperationalError: no such table: lists list 


因此 需要 执行 一 次 makemigrations 命令 : 


$ python manage.py makemigrations 
Migrations for 'lists': 
lists/migrations/0003 list.py 
- Create model List 


然后 会 看 到 : 


self.assertEqual(first saved item.list, list ) 
AttributeError: 'Item' object has no attribute 'list' 


7.9.1 外 键 关 系 


Item 的 list 属性 应 该 怎么 实现 呢 ? 先天 真一 点 ， 把 它 当 成 text 属性 试 试 (你 可 以 借 机 看 
一 下 你 的 实现 方式 与 我 的 有 什么 区 别 ) : 




















lists/models.py 
from django.db import models 


class List(models.Model): 
pass 


class Item(models.Model): 
text = models.TextField(default-'') 
list = models.TextField(default-'') 


照例 ， 测 试 会 告诉 我 们 需要 做 一 次 迁移 : 


$ python manage.py test lists 


[...] 


django.db.utils.OperationalError: no such column: lists item.list 


$ python manage.py makemigrations 
Migrations for 'lists': 
lists/migrations/0004 item list.py 
- Add field list to item 


看 一 下 测试 结果 如 何 : 

AssertionError: 'List object' != <List: List object> 
离 成 功 还 有 一 段 距离 。 请 仔细 看 != 两 边 的 内 容 。Django 只 保存 了 List 对象 的 字符 串 
形式 。 若 想 保 存 对 象 之 间 的 关系 ， 要 告诉 Django 两 个 类 之 间 的 关系 ， 这 种 关系 使 用 
ForeignKey 字段 表示 : 




















lists/models.py 


from django.db import models 


class List(models.Model): 
pass 


class Item(models.Model): 
text = models.TextField(default-'') 
list = models.ForeignKey(List, default-None) 


修改 之 后 也 要 做 一 次 迁移 。 既 然 前 一 个 迁移 没 用 了 ， 就 把 它 删 掉 吧 ， 换 一 个 新 的 : 


$ rm lists/migrations/0004 item list.py 
$ python manage.py makemigrations 
Migrations for 'lists': 
lists/migrations/0004 item list.py 
- Add field list to item 





删除 迁移 是 种 危险 操作 ， 但 偶尔 需要 这 么 做 ， 因 为 不 可 能 从 一 开始 就 正确 
定义 模型 。 如 果 删 除 已 经 用 于 某 个 数据 库 的 迁移 ，Django 就 不 知道 当前 状 
态 ， 因 此 也 就 不 知道 如 何 和 运行 以 后 的 迁移 。 只 有 当 你 确定 某 个 迁移 没 被 使 
用 时 才能 将 其 删除 。 根 据 经 验 ， 已 经 提交 到 VCS 的 迁移 决 不 能 删除 。 





























7.9.2 ”根据 新 模型 定义 调整 其 他 代码 
再 看 测试 的 结果 如 何 ; 


$ python manage.py test lists 

Ds] 

ERROR: test displays all items (lists.tests.ListViewTest) 
django.db.utils.IntegrityError: NOT NULL constraint failed: lists item.list id 
Ls] 

ERROR: test redirects after POST (lists.tests.NewListTest) 
django.db.utils.IntegrityError: NOT NULL constraint failed: lists item.list id 
[e] 

ERROR: test can save a POST request (lists.tests.NewListTest) 
django.db.utils.IntegrityError: NOT NULL constraint failed: lists item.list id 


Ran 6 tests in 0.021s 
FAILED (errors-3) 
天 啊 ， 这 么 多 错误 。 


可 是 也 有 一 些 好 消息 。 虽 然 很 难看 出 ， 不 过 模型 测试 通过 了 。 但 是 三 个 视图 测试 出 现 了 重 
大 错误 。 

出 现 这 些 错 误 是 因为 我 们 在 待 办 事项 和 清单 之 间 建 立 了 关联 ， 在 这 种 关联 中 ， 每 个 待 办 事 
项 都 需要 一 个 父 级 清单 ， 但 是 原来 的 测试 和 代码 并 没有 考虑 到 这 一 点 。 

不 过 ， 这 正 是 测试 的 目的 所 在 。 下 面 要 让 测试 再 次 通过 。 最 简单 的 方法 是 修改 ListViewTest, 








pun 
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为 测试 中 的 两 个 待 办 事项 创建 父 清单 : 











lists/tests.py (ch07103 I) 


class ListViewTest(TestCase): 


def test displays all items(self): 
list = List.objects.create() 
Item.objects.create(text-'itemey 1', list-list ) 
Item.objects.create(text-'itemey 2', list-list ) 


修改 之 后 ， 失 败 测试 减少 到 两 个 ,而且 都 是 向 new list 视图 发 送 POST 请 求 引起 的 。 使 用 
惯用 的 技术 分 析 调用 眼 踪 ， 由 错误 消息 找到 导 臻 错误 的 测试 代码 ， 然 后 再 找 出 相应 的 应 用 
代码 ， 最 终 定位 到 下 面 这 行 : 

File "/.../superlists/lists/views.py", line 9, in new list 


Item.objects.create(text-request.POST['item text']) 


这 行 调用 跟踪 表明 创建 待 办 事项 时 没有 指定 父 清 单 。 因 此 ， 要 对 视图 做 类 似 修改 : 




















lists/views.py 


from lists.models import Item, List 

[x] 

def new list(request): 
list = List.objects.create() 
Item.objects.create(text-request.POST['item text'], list-list ) 
return redirect('/lists/the-only-list-in-the-world/') 


修改 之 后 ， 测 试 又 能 通过 了 : 


Ran 6 tests in 0.030s 


OK 


此 时 你 是 不 是 感觉 不 舒畅 ”我们 为 每 个 新 建 的 待 办 事项 都 指定 了 所 属 的 清单 ， 但 还 是 集中 
显示 所 有 竺 办事 项， 好 像 它们 都 属于 同一 个 清单 似 的 一 一 感觉 这 么 做 完全 不 对 。 我 知道 不 
对 ， 我 也 有 同样 的 感觉 。 我 们 采用 的 步 进 方式 与 直觉 不 一 致 ， 要 求 代 码 从 一 个 可 用 状态 变 
成 另 一 个 可 用 状态 。 我 总 想 直 接 动手 一 次 修正 所 有 问题 ， 而 不 想 把 一 个 奇怪 的 半成品 变 成 
另 一 个 半成品 。 可 是 你 还 记得 测试 山羊 吗 ?中 山 时 ， 你 要 审慎 抉择 每 一 步 踏 在 何 处 ， 而 且 
一 次 只 能 迈 一 步 ， 确 认 脚 踩 的 每 一 个 位 置 都 不 会 让 你 跌落 悬崖 。 
因此 ， 为 了 确信 一 切 都 能 正常 运行 ， 要 再 次 运行 功能 测试 : 

AssertionError: '1: Buy milk' not found in ['1: Buy peacock feathers', '2: Buy 

milk'] 

[a 
毫 无 疑问 ， 测 试 的 结果 和 修改 前 一 样 。 现 有 功能 没有 破坏 ， 在 此 基础 上 还 修改 了 数据 库 。 
这 一 点 令 人 欣喜 ! 下 面 提交 : 
git status # 改动 了 3 个 文件 ， 还 新 建 了 2 个 迁移 
git add lists 


git diff --staged 
git commit 
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又 可 以 从 待 办 事项 清单 上 划 掉 一 个 问题 了 : 

















。- 调 整 模型， 让 待 办 事项 和 丰 同 的 清单 关联 起 来 

。 为 香 个 清单 添加 唯一 的 URL 

。 话 加 通过 POS 于 请 求 新 建 清单 所 需 的 HUREL 

。 添 加 通过 POST 请 求 在 现 少 的 清单 中 增加 新 待 办 事项 所 需 的 URL 


ait, ut, mme 

















7.10 每 个 列表 都 应 该 有 自己 的 URL 


应 该 使 用 什么 作为 清单 的 唯一 标识 符 呢 ? 就 目前 而 言 ， 或 许 最 简单 的 处 理 方式 是 使 用 数据 
































库 自 动 生成 的 id 字段 。 下 面 修改 ListviewTest， 让 其 中 的 两 个 测试 指向 新 URL. 


还 要 把 test displays all items 测试 重 命名 为 test_displays_only_items_for_that_list, 
文 个 测试 中 确认 只 显示 属于 这 个 清单 的 待 办 事项 : 





然后 在 这 











lists/tests.py (ch071033) 


class ListViewTest(TestCase): 


def 


def 


test uses list template(self): 

list = List.objects.create() 

response = self.client.get(f'/lists/[list .id)/') 
self.assertTemplateUsed(response, 'list.html') 


test displays only items for that list(self): 

correct list = List.objects.create() 
Item.objects.create(text-'itemey 1', list-correct list) 
Item.objects.create(text-'itemey 2', list-correct list) 

other list - List.objects.create() 
Item.objects.create(text-'other list item 1', list-other list) 
Item.objects.create(text-'other list item 2', list-other list) 


response = self.client.get(f'/lists/[correct list.id)/') 


self.assertContains(response, 'itemey 1') 
self.assertContains(response, 'itemey 2') 
self.assertNotContains(response, 'other list item 1') 
self.assertNotContains(response, 'other list item 2') 
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这 个 代码 清单 又 用 到 了 几 个 ff 字符 串 。 如 果 你 还 是 不 太 了 解 ， 下 文档 
(https:/Wdocs.python.org/3/reference/lexical_analysis.html#f-strings)。( 如 果 你 跟 
我 一 样 没 正式 学 习 过 CS， 或许 应 该 跳 过 正式 的 语法 。) 




















运行 这 个 单元 测试 ， 会 看 到 预期 的 404， 以 及 另 一 个 相关 的 错误 : 


FAIL: test displays only items for that list (lists.tests.ListViewTest) 
AssertionError: 404 !- 200 : Couldn't retrieve content: Response code was 404 
(expected 200) 


[esal 
FAIL: test_uses_list_template (lists.tests.ListViewTest) 
AssertionError: No templates used to render the response 


7.10.1 捕获 URL 中 的 参数 


现在 要 学 习 如 何 把 URL 中 的 参数 传人 视图 : 


superlists/urls.py 


urlpatterns = [ 
url(r'^$', views.home page, name-'home'), 
url(r'^lists/newS', views.new list, name-'new list'), 
url(r'^lists/(.4)/$', views.view list, name-'view list'), 


] 
调整 URL 映射 中 使 用 的 正则 表达 式 ， 加 入 一 个 捕获 组 (capture group，.+)， 它 能 匹配 随 
后 / 之 前 的 任意 个 字符 。 捕 获得 到 的 文本 会 作为 参数 传人 视图 。 
也 就 是 说 ， 如 果 访 问 /lists/1/，view_list 视图 除了 常规 的 request 参数 之 外 ， 还 会 获得 第 
二 个 参数 ， 即 字符 串 "1"。 如 果 访 问 /lists/foo/， 视 图 就 是 view list(request, "foo"), 
但 是 视图 并 未 期 待 有 参数 传人， 毫 无 疑问 ， 这 么 做 会 导致 问题 : 


ERROR: test displays only items for that list (lists.tests.ListViewTest) 


[c] 


TypeError: view list() takes 1 positional argument but 2 were given 








[s] 

ERROR: test_uses_list_template (lists.tests.ListViewTest) 

[si] 

TypeError: view list() takes 1 positional argument but 2 were given 
| We 

ERROR: test redirects after POST (lists.tests.NewListTest) 

[L-e] 


TypeError: view_list() takes 1 positional argument but 2 were given 
FAILED (errors=3) 


这 个 问题 容易 修正 ， 在 views.py 中 加 入 一 个 参数 即 可 : 





lists/views.py 


def view list(request, list id): 


[...] 














现在 ， 前 面 那个 预期 失败 解决 了 : 


FAIL: test displays only items for that list (lists.tests.ListViewTest) 


[...] 


AssertionError: 1 !- 0 : Response should not contain 'other list item 1' 


接 下 来 要 让 视图 决定 把 哪些 待 办 事项 传人 模板 : 











lists/views.py 


def view list(request, list id): 
list = List.objects.get(id-list id) 
items - Item.objects.filter(list-list ) 
return render(request, 'list.html', ['items': items]) 


7.10.2 ”按照 新 设计 调整 new_List 视 图 
现在 得 到 发 生 在 另 一 个 测试 中 的 错误 : 


ERROR: test redirects after POST (lists.tests.NewListTest) 
ValueError: invalid literal for int() with base 10: 
'the-only-list-in-the-world' 


既然 这 个 测试 报错 了 ， 就 来 看 看 它 的 代码 吧 : 


lists/tests.py 
class NewListTest(TestCase): 


[...] 


def test redirects after POST(self): 
response = self.client.post('/lists/new', data-('item text': 'A new list item']) 
self.assertRedirects(response, '/lists/the-only-list-in-the-world/') 


看 样子 这 个 测试 还 没 按照 清单 和 待 办 事项 的 新 设计 调整 ， 它 应 该 检查 视图 是 否 重 定向 到 指 
定 新 建 清单 的 URL: 












































lists/tests.py (ch071036-1) 


def test redirects after POST(self): 
response - self.client.post('/lists/new', data-('item text': 'A new list item']) 
new list - List.objects.first() 
self.assertRedirects(response, f'/lists/(new list.id]/') 


修改 后 测试 还 是 得 到 无 效 字面 量 错 误 。 检 查 一 下 视图 本 身 ， 把 它 改 为 重 定向 到 有 效 的 
地 址 : 





lists/views.py (ch071036-2) 


def new list(request): 
list = List.objects.create() 
Item.objects.create(text-request.POST['item text'], list-list ) 
return redirect(f'/lists/([list .id)/') 


这 样 修改 之 后 单元 测试 就 可 以 通过 了 : 





>- 
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$ python3 manage.py test lists 
..] 


Ran 6 tests in 0.033s 
OK 


那么 功能 测试 结果 如 何 ? 差不多 也 能 通过 吧 ? 


7.11 功能 测试 又 检测 到 回归 


FAIL: test can start a list for one user 
(functional tests.tests.NewVisitorTest) 


Traceback (most recent call last): 
File "/.../superlists/functional tests/tests.py", line 67, in 
test can start a list for one user 
self.wait for row in list table('2: Use peacock feathers to make a fly') 


[...] 


AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Use 
peacock feathers to make a fly'] 


Ran 2 tests in 8.617s 
FAILED (failures-1) 


新 测试 其 实 通过 了 ， 不 同 的 用 户 有 不 同 的 清单 ， 但 是 旧 测试 提醒 我 们 出 现 了 回归 。 看 起 来 
无 法 在 清单 中 添加 第 二 个 待 办 事项 。 这 是 因为 我 们 投机 取 巧 了 ， 每 次 POST 提交 都 新 建 一 
个 清单 。 这 正 是 编写 功能 测试 的 目的 ! 

而 这 正好 和 待 办 事项 清单 中 最 后 一 个 问题 高 度 吻 合 : 
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。- 添 加 通过 POST 请 求 新 建 清 单 所 需 的 UR 








。 添 加 通过 POST 请 求 在 现 用 的 清单 中 增加 新 待 办 事项 所 需 的 URL 




















7.12 ”还 需要 一 个 视图 ， 把 待 办 事项 加 入 现 有 清 


还 需要 一 个 URL 和 视图 (/lists/<list_id>/add_item)， 把 新 待 办 事项 添加 到 现 有 的 清单 中 。 
我 们 已 经 熟知 这 种 操作 了 ， 因 此 可 以 一 次 写 好 两 个 测试 : 




















lists/tests.py 


class NewItemTest(TestCase): 


def test can save a POST request to an existing list(self): 
other list = List.objects.create() 
correct list = List.objects.create() 


self.client.post( 
f'/lists/(correct list.id]/add item', 
data-('item text': 'A new item for an existing list'} 


) 


self.assertEqual(Item.objects.count(), 1) 

new item - Item.objects.first() 

self.assertEqual(new item.text, 'A new item for an existing list') 
self.assertEqual(new item.list, correct list) 


def test redirects to list view(self): 
other list = List.objects.create() 
correct list = List.objects.create() 


response - self.client.post( 
f'/lists/(correct list.id]/add item', 
data-('item text': 'A new item for an existing list'} 


) 
self.assertRedirects(response, f'/lists/[correct list.id)/') 


你 是 不 是 觉得 奇怪 ， 想 知道 为 什么 要 用 other list ? 这 与 查看 某 个 清单 的 测 
试 类 似 ， 要 确保 把 待 办 事项 添加 到 特定 的 清单 中 。 在 数据 库 中 再 存储 一 个 对 
象 便 无 须 使 用 List.objects.first() 这 样 可 能 出 错 的 代码 。 HEFERGEAOSU, 
如 果真 做 了 ， 你 可 能 会 为 之 付出 惨痛 代价 〈 毕 竟 数 字 有 无 穷 多 个 ) 。 这 只 是 
主观 选择 ， 不 过 我 觉得 值得 这 么 做 。 详 情 请 参见 15.1.1 节 。 


测试 的 结果 为 : 


AssertionError: 0 !- 1 


[«] 
AssertionError: 301 !- 302 : Response didn't redirect as expected: Response 
code was 301 (expected 302) 


7.12.1 小 心 霸道 的 正则 表达 式 


有 点 奇怪 ， 还 没 在 URL 映射 中 加 入 /lists/1/add_item， 应 该 得 到 404 != 302 错误 ， 怎 么 会 
日 
是 301 呢 ? 
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确实 令 人 费解 。 其 实 得 到 这 个 错误 是 因为 在 URL 映射 中 使 用 了 一 个 非常 霸道 的 正则 表达 式 : 





super lists/urls.py 


url(r'^lists/(.4)/$', views.view list, name-'view list'), 


根据 Django 的 内 部 处 理 机 制 ， 如 果 访 问 的 URL 几乎 正确 ， 但 却 少 了 末尾 的 斜 线 ， 就 会 得 到 
一 个 永久 重 定向 响应 (301)。 在 这 里 ，/lists/1/add_item/ 符合 Lists/(.+)/ 的 匹配 模式 ， 其 中 
(.+) 捕获 1/add_item， 所 以 Django 伸 出 “援手 ”， 猜 测 你 其 实 是 想 访 问 末尾 带 斜 线 的 URL., 


这 个 问题 的 修正 方法 是 ， 显 式 指定 URL 模式 只 捕获 数字 ， 即 在 正则 表达 式 中 使 用 Md: 











super lists/urls.py 
url(r'^lists/(Md*)/$', views.view list, name-'view list'), 
修改 后 测试 的 结果 是 : 
AssertionError: 0 != 1 
[5««1 
AssertionError: 404 !- 302 : Response didn't redirect as expected: Response 


code was 404 (expected 302) 


7.12.2 最 后 一 个 新 URL 
现在 得 到 了 预期 的 404。 下 面 定义 一 个 新 URL， 用 于 把 新 待 办 事项 添加 到 现 有 清单 中 : 




















superlists/urls.py 


urlpatterns = [ 
url(r'^$', views.home page, name-'home'), 
url(r'^lists/newS$', views.new list, name-'new list'), 
url(r'^lists/(Md4)/S', views.view list, name-'view list'), 
url(r'^lists/(VAd«)/add itemS', views.add item, name-'add item'), 


] 


现在 URL 映射 中 定义 了 三 个 类 似 的 URL。 在 待 办 事项 清单 中 做 个 记录 ， 因 为 这 三 个 URL 
看 起 来 需要 重 构 。 
























。 洞 间 模型， 社 待 办 下 项 和 下 同 的 济 音 关联 起 
一 一 一 一 一 一 一 一 

EET EPEE 

e SEP POSF REAA 4 t3 9 3 A AORE 
。 重 构 urls.py， 去 除 重 复 


AAA AAA 


























再 看 测试 ， 现 在 又 提示 视图 模块 缺少 属性 : 


AttributeError: module 'lists.views' has no attribute 'add item' 


7.12.8 最 后 一 个 新 视图 


定义 下 面 这 个 视图 试 试 : 





























lists/views.py 


def add item(request): 
pass 


效果 不 错 : 
TypeError: add item() takes 1 positional argument but 2 were given 


继续 修改 视图 : 





lists/views.py 
def add item(request, list id): 
pass 


测试 的 结果 是 : 


ValueError: The view lists.views.add item didn't return an HttpResponse object. 
It returned None instead. 





可 以 从 new. list 视图 中 复制 redirect, M view list 视图 中 复制 List.objects.get: 











lists/views.py 


def add item(request, list id): 
list = List.objects.get(id-list id) 
return redirect(f'/lists/[list .id)/') 


现在 测试 的 结果 为 : 


self.assertEqual(Item.objects.count(), 1) 
AssertionError: 0 !- 1 


最 后 ， 让 视图 保存 新 建 的 待 办 事项 : 








| 





lists/views.py 


def add item(request, list id): 
list = List.objects.get(id-list id) 
Item.objects.create(text-request.POST['item text'], list-list ) 
return redirect(f'/lists/([list .id)/') 


这 样 ， 测 试 又 能 通过 了 : 
Ran 8 tests in 0.050s 


OK 
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7.12.4 直接 测试 响应 上 下 文 对 象 


把 待 办 事项 添加 到 现 有 清单 所 需 的 视图 和 URL 都 有 了 ， 现 在 只 剩 在 list.html 模板 中 使 用 它 
们 了 。 打 开 这 个 模板 ， 修 改 表单 标签 : 



































lists/templates/list.html 
«form method="POST" action-"but what should we put here?"> 
可 是 ， 若 想 获取 添加 到 当前 清单 的 URL， 模 板 要 知道 它 浑 染 的 是 哪个 清单 ， 以 及 要 添加 哪 
些 竺 办事 项。 和 希望 表单 能 写成 下 面 这 样 ; 





lists/templates/list.html 
«form method="POST" action-"/lists/(( list.id )j/add item" 


为 了 能 这 样 写 ， 视 图 要 把 清单 传 和 人 模板。 下面 在 ListVtewTest 中 新 建 一 个 单元 测试 方法 : 
lists/tests.py (ch07104 1) 

















def test passes correct list to template(self): 
other list = List.objects.create() 
correct list = List.objects.create() 
response = self.client.get(f'/lists/[correct list.id)/') 
self.assertEqual(response.context['list'], correct list) ©@ 


©  response.context 表示 要 传人 render 函数 的 上 下 文 一 一 Django 测试 客户 端 把 上 下 文 附 
在 response 对 象 上 ， 方 便 测 试 。 


增加 这 个 测试 后 得 到 的 结果 如 下 : 
KeyError: 'list' 


这 是 因为 没 把 List 传人 模板 ， 其 实 也 给 了 我 们 一 个 简化 视图 的 机 会 : 


























lists/views.py 


def view list(request, list id): 
list = List.objects.get(id-list id) 
return render(request, 'list.html', ['list': list }) 


这 么 做 显然 会 破坏 一 个 旧 测 试 ， 因 为 模板 需要 items: 


FAIL: test displays only items for that list (lists.tests.ListViewTest) 


je 7] 


AssertionError: False is not true : Couldn't find 'itemey 1' in response 
可 以 在 list.html 中 修正 这 个 问题 ， 同 时 还 要 修改 表单 POST 请 求 的 目标 地 址 ， 即 action 属性 : 


lists/templates/list.html (ch071043) 
«form method="POST" action-"/lists/(([ list.id }}/add item" © 





[s] 


(X for item in list.item set.all X) @ 
<tr><td>{{ forloop.counter }}: {{ item.text }}</td></tr> 
{% endfor 96) 
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0 ”这 是 新 的 目标 地 址 。 


©  .item set 叫 作 反 向 查询 (reverse lookup)， 是 Django 提供 的 非常 有 用 的 ORM 功能 ， 作 
用 是 在 其 他 表 中 查询 某 个 对 象 的 相关 记录 。 


修改 模板 之 后 ， 单 元 测试 能 通过 了 : 


Ran 9 tests in 0.040s 














OK 


功能 测试 的 结果 如 何 呢 ? 





$ python manage.py test functional tests 


Ran 2 tests in 9.771s 
OK 


太 好 了 ! 再 看 一 下 待 办 事项 清单 : 























。- 调 整 模型 一 让 待 办 事项 和 于 同 的 清单 关联 起 来 

。- 为 委 个 清单 添加 唯一 的 UR 

。 添 加 通过 POST 请 求 新 建 清单 所 需 的 URL 

。- 译 加 通过 POS 王 请求 在 现 者 的 清单 中 增加 新 待 办 事项 所 需 的 HR 
。 重 构 urls.py， 去 除 重 复 


Ap AAA 


























可 惜 ， 测 试 山 羊 也 是 善 始 不 善终 的 ， 还 有 最 后 一 个 问题 没 解决 。 
在 解决 这 个 问题 之 前 ， 先 做 提交 一 一 着 手 重 构 之 前 一 定 要 提交 可 正常 运行 的 代码 : 


$ git diff 
$ git commit -am "new URL + view for adding to existing lists. FT passes :-)" 


7.43 使 用 URL 引 入 做 最 后 一 次 重 构 


superlists/urls.py 的 真正 作用 是 定义 整个 网 站 使 用 的 URL。 如 果 某 些 URL 只 在 lists 应 用 
中 使 用 ，Django 建议 使 用 单独 的 文件 lists/urls.py， 让 应 用 自 成 一 体 。 定 义 lists 使 用 的 
URL， 最 简单 的 方法 是 复制 现 有 的 urls.py: 
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$ cp superlists/urls.py lists/ 
然后 把 superlists/urls.py 中 的 三 行 定 义 换 成 一 个 include; 


super lists/urls.py 


from django.conf.urls import include, url 
from lists import views as list views © 
from lists import urls as list urls Q9 


urlpatterns - [ 
url(r'^$', list views.home page, name-'home'), 
url(r'^lists/', include(list urls)), @ 
] 
@ 顺便 使 用 import x as y 句法 为 视图 和 URL 映射 创建 别名 。 在 顶层 urls.py 中 ， 这 是 个 
好 做 法 ， 便 于 从 多 个 应 用 中 引入 视图 和 URL 映射。 其实 ， 后 文 就 会 这 么 做 。 
@ ”这 是 那个 include。 注 意 ，include 可 以 使 用 一 个 正则 表达 式 作 为 URL 的 前 级 ， 这 个 
前 级 会 添加 到 引入 的 所 有 URL 前 面 ( 这 就 是 去 除 重复 的 方法 ， 同 时 也 让 代码 结构 更 
清晰 )。 


回 到 lists/urls.py 中 ， 我 们 只 需 写 入 那 三 个 URL 的 后 半 部 分 ， 而 且 不 用 再 写 父 级 urls.py 中 的 
其 他 定义 : 


























lists/urls.py(ch071046) 


from django.conf.urls import url 
from lists import views 


urlpatterns - [ 
url(r'^newS', views.new list, name-'new list'), 
url(r'^(\d+)/$', views.view list, name-'view list'), 
url(r'^(\d+)/add_item$', views.add item, name-'add item'), 


] 
再 次 运行 单元 测试 ， 确 认 一 切 仍 能 正常 运行 。 
我 修改 时 ， 怀 疑 自 己 的 能 力 ， 不 确信 能 一 次 改 对 ， 所 以 特意 一 次 只 改 一 个 URL， 防 止 测试 
失败 。 如 果 改 错 了 ， 还 有 测试 提醒 我 们 。 
你 可 以 动手 试 一 下 。 记 得 要 改 回来 ， 而 且 要 确认 测试 全 部 都 能 通过 ， 然 后 再 提 

















Kt 





$ git status 

$ git add lists/urls.py 

$ git add superlists/urls.py 
$ git diff --staged 

$ git commit 


终于 结束 了 ， 这 一 章 可 真 长 啊 。 我 们 讨论 了 很 多 重要 话题 ， 先 从 测试 隔离 开始 ， 然 后 又 
思考 了 设计 。 介 绍 了 一 些 经 验 法 则 ， 比 如 “YAGNI” 和 “ 事 不 过 三 ， 三 则 重 构 ”。 最 重要 
的 是 ， 看 到 了 如 何 一 步 步 修 改 现 有 网 站 ， 从 一 个 可 运行 状态 变 成 另 一 个 可 运行 状态 ， 逐 渐 
实现 新 设计 。 
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不 得 不 说 ， 我 们 的 网 站 已 经 非常 接近 发 布 状态 了 ， 也 就 是 说 ， 这 个 待 办 事项 清单 网 站 的 首 
个 测试 版 可 以 公之于众 了 。 不 过 ， 在 此 之 前 可 能 还 要 做 些 美化 。 在 接 下 来 的 儿童 中 ， 我 们 





要 介绍 部 署 网 站 时 需要 做 些 什么 。 





更 多 TDD 哲学 
。 从 一 个 可 运行 状态 到 另 一 个 可 运行 状态 (又 叫 测 试 山羊 与 重 构 猫 ) 
本 能 经 常 驱使 我 们 直接 动手 一 次 修正 所 有 问题 ， 但 如 果 不 小 心 ， 


最 
一 样 ， 改 动 了 很 多 代码 但 都 不 起 作用 。 测 试 山羊 建议 我 们 一 次 只 迈 一 步 ， 从 一 个 可 


运行 状态 走 到 另 一 个 可 运行 状态 。 


。 把 工作 分 解 成 易于 实现 的 小 任务 


有 时 ,我 们 要 从 “乏味 的 ”工作 入 手 ， 而 不 是 直 指 有 趣 的 任务 。 你 要 相信 人 只 
一 次 ， 平 行 宇宙 中 的 另 一 个 你 可 能 过 得 并 不 好 ， 把 功能 都 破坏 了 ， 极 尽 所 能 想 ; 
用 再 次 运行 起 来 。 

* YAGNI 


“You ain't gonna need it”( 你 不 需要 这 个 ) 的 简称 ， 劝 诚 你 不 要 受 诱惑 编写 当时 看 
起 来 可 能 有 用 的 代码 。 很 有 可 能 你 根本 用 不 到 这 些 代码 ， 或 者 没有 准确 预见 未 来 的 





需求 。 第 22 章 给 出 了 一 种 方法 ， 可 以 让 你 避免 落 入 这 个 陷阱 。 





PE 
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第 二 部 分 


Web 开发 要 素 





“真正 的 开发 者 一 定 会 发 布 自己 的 产品 。 
Jeff Atwood 
如 果 这 是 一 本 普通 编程 领域 内 的 TDD 入 门 书 ， 到 这 里 我 们 就 可 以 庆贺 一 香 了 ， 毕 况 我 们 
已 经 掌握 了 扎实 的 TDD 和 Django 基础 ， 也 具备 了 开始 开发 网 站 所 需 的 一 切 知识 。 

但 是 ， 真 正 的 开发 者 一 定 会 发 布 自己 的 产品 ， 那 就 无 法 回避 Web 开发 中 的 一 些 琼 手 问题 ， 
比如 静态 文件 、 表 单数 据 验证 、 可 怕 的 JavaScript 等 ， 但 最 令 人 惧怕 的 还 是 部 署 到 生产 服 
务 器 。 

在 每 个 阶段 ，TDD 都 能 协助 我 们 正确 处 理 这 些 问 题 。 

在 这 一 部 分 中 ， 我 仍 会 尽量 让 学 习 曲 线 保持 平缓 ， 而 且 我 们 会 学 到 多 个 重要 的 新 概念 和 技 
术 。 我 不 会 深入 展开 每 个 话题 ， 只 是 希望 我 所 演示 的 方法 足够 你 在 自己 的 项 目 中 开始 使 
用 。 如 果真 想 在 实际 工作 中 使 用 这 些 技 术 ， 你 还 得 做 些 扩展 阅读 。 

如 果 你 开始 阅读 本 书 之 前 并 不 熟悉 Django， 现 在 花 点 时 间 读 一 所 Django 官方 教程 ， 能 很 
好 地 巩固 目前 所 学 的 知识 。 熟 悉 Django 的 相关 概念 后 ， 你 会 更 自信 ， 在 接 下 来 的 儿童 中 ， 
能 专注 于 我 要 讲 的 核心 概念 。 

这 一 部 分 有 很 多 有 趣 的 知识 ， 敬 请 期 待 ! 
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美化 网 站 ， 布局、 样式 及 其 测试 方法 


我 们 正 考 虑 要 发 布 网 站 的 第 一 个 版 本 ， 但 让 人 燃 俯 的 是 ， 网 站 现在 看 起 来 还 很 简陋 。 本 章 


介绍 一 些 样式 基础 知识 ， 包 括 如 何 集成 Bootstrap 这 个 HTML/CSS 框架 ， 
处 理 静态 文件 的 方式 ， 以 及 如 何 测试 静态 文件 。 


8.1 如 何在 功能 测试 中 测试 布局 和 样式 


不 可 否认 ， 我 们 的 网 站 现在 没有 太 大 的 吸引 力 (如 图 8-1). 








还 要 学 习 Django 





®©- o To-Do lists - Mozilla Firefox 
| 2 To-Do lists | ar | 


€ ® localhost v Q | | 图 ~ Goog Qa V 


Start a To-Do list 





O- x 





Se. 





8-1: 首页 ， 有 点 简陋 
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执行 命令 manage.py runserver 启动 开发 服务 器 时 ， 可 能 会 看 到 一 个 数据 库 
ai ix: “table lists item has no column named list id" (lists item 表 中 没有 名 为 
list id 的 列 )。 此 时 ， 需 要 执行 manage.py migrate 命令 ， 更 新 本 地 数据 库 ， 
让 models.py 中 的 改动 生效 。 如 果 提 醒 IntegrityErrors， 就 删除 ' 数据 库 文 
件 ， 然 后 再 试 。 





既然 不 参加 Python 世界 的 选 丑 竞赛 ， 就 要 美化 这 个 网 站 。 或 许 我 们 想 实现 如 下 效果 。 


。 一 个 精美 且 很 大 的 输入 框 ， 用 于 新 建 清单 ， 或 者 把 待 办 事项 添加 到 现 有 的 清单 中 。 
。 把 这 个 输入 框 放 在 一 个 更 大 的 居中 框 体 中 ， 吸 引用 户 的 注意 力 。 


应 该 怎么 使 用 TDD 实现 这 些 效果 呢 ? 大 多 数 人 都 会 告诉 你 ， 不 要 测试 外 观 。 他 们 是 对 的 ， 
这 就 像 是 测试 常量 一 样 之 无 意义 。 

但 可 以 测试 装饰 外 观 的 方式 ， 确 信 实 现 了 预期 的 效果 即 可 。 例 如 ， 使 用 层 倒 样式 表 
(Cascading Style Sheet, CSS) 编写 样式 ， 样 式 表 以 静态 文件 的 形式 加 载 ， 而 静态 文件 配置 
起 来 有 点 儿 复 杂 ( 稍 后 会 看 到 ， 把 静态 文件 移 到 主机 上 ， 配 置 起 来 更 麻烦 )， 因 此 只 需 做 
某 种 “ 冒 烟 测试 ”(smoke test) ， 确 保 加 载 了 CSS 即 可 。 无 须 测 试 字体 、 颜 色 以 及 像素 级 
位 置 ， 而 是 通过 简单 的 测试 ， 确 认 重要 的 输入 框 在 每 个 页 面 中 都 按照 预期 的 方式 对 齐 ， 由 
此 推断 页 面 中 的 其 他 样式 或 许 也 都 正确 应 用 了 。 


先 在 功能 测试 中 编写 一 个 新 测试 方法 : 



































functional tests/tests.py (ch081001) 


class NewVisitorTest(LiveServerTestCase): 


D] 


def test_layout_and_styling(self): 
# 伊 迪 丝 访问 首页 
self.browser.get(self.live server url) 
self.browser.set window size(1024, 768) 




















# 她 看 到 输入 框 完美 地 居中 显示 
inputbox = self.browser.find element by id('id new item') 
self.assertAlmostEqual( 
inputbox.location['x'] + inputbox.size['width'] / 2, 
512, 
delta-10 








) 


这 里 有 些 新 知识 。 先 把 浏览 器 的 窗口 设 为 固定 大 小 ， 然 后 找到 输入 框 元 素 ， 获 取 它 的 大 小 
和 位 置 ， 再 做 些 数学 计算 ,检查 输入 框 是 否 位 于 网 页 的 中 线 上 。assertAlmostEqual 的 作 
用 是 帮助 处 理 舍 人 误差 以 及 偶尔 由 滚动 条 等 事物 导致 的 异常 ， 这 里 指定 计算 结果 在 正 负 10 
像素 范围 内 为 可 接受 


















































注 1: 什么 ? 删除 数据 库 ? 疯 了 吗 ? 并 没有 。 在 开发 的 过 程 中 ， 本 地 开发 数据 库 经 常 与 迁移 不 同步 ， 而 且 里 
面 也 没什么 重要 数据 , 因此 可 以 放心 删除 。 不 过 要 谨慎 对 待 生产 服务 器 中 的 数据 库 , 详情 请 参见 附录 D. 
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E 测 试 会 得 到 如 下 结果 : 


python manage.py test functional tests 


运行 如 


e s 


Traceback (most recent call last): 
File "/.../superlists/functional tests/tests.py", line 129, in 
test layout and styling 
delta-10 
AssertionError: 107.0 !- 512 within 10 delta 


Ran 3 tests in 9.188s 


FAILED (failures-1) 


这 次 失败 在 预料 之 中 。 测试 很 容易 出 错 ， 所 以 要 用 一 种 有 点 作 浆 的 快捷 方法 
确认 输入 框 居 中 时 功能 测试 能 通过 。 一 旦 确认 功能 测试 编写 正确 之 后 ， 就 把 这 些 代码 删 掉 : 


lists/templates/home.html (ch081002) 











«form method="POST" action-"/lists/new"» 
«p style-"text-align: center;"» 
«input name-"item text" id-"id new item" placeholder-"Enter a to-do item" /> 
</p> 
{% csrf_token %} 
</form> 


修改 之 后 测试 能 通过 ， 说 明 功 能 测试 起 作用 了 。 下 面 扩展 这 个 测试 ， 确 保 新 建 请 单 后 输入 
框 仍然 居中 对 齐 显 示 : 

















functional tests/tests.py (ch081003) 


# 她 新 建 了 一 个 清单 ， 看 到 输入 框 仍 完美 地 居中 显示 
inputbox.send keys('testing') 
inputbox.send keys(Keys.ENTER) 
self.wait for row in list table('1: testing') 
inputbox = self.browser.find element by id('id new item') 
self.assertAlmostEqual( 
inputbox.location['x'] + inputbox.size['width'] / 2, 
517, 
delta-10 

















) 
这 会 导致 测试 再 次 失败 : 


File "/.../superlists/functional tests/tests.py", line 141, in 
test layout and styling 
delta-10 
AssertionError: 107.0 !- 512 within 10 delta 


现在 只 提交 功能 测试 
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$ git add functional tests/tests.py 
$ git commit -m "first steps of FT for layout + styling" 


现在 ， 似 乎 找到 了 满足 需求 的 适当 解决 方案 ， 能 更 好 地 样式 化 网 站 。 那 么 就 退回 添加 
«p style-"text-align: center"> 之 前 的 状态 吧 : 





e 


$ git reset --hard 





git reset --hard 是 一 个 破坏 力 极 强 的 Git 命令 ， 它 会 还 原 所 有 没 提交 的 改 
动 ， 所 以 使 用 时 要 小 心 。 它 和 几乎 所 有 其 他 Git 命令 都 不 同 ， 执 行 之 后 无 法 
撤销 操作 。 





8.2 ”使 用 CSS 框 架 美 化 网 站 


设计 不 简单 ， 现 在 更 难 ， 因 为 要 处 理 手 机 、 平 板 等 设备 。 所 以 很 多 程序 员 ， 尤 其 是 像 我 一 
样 的 同人， 都 转 而 使 用 CSS 框架 解决 问题 。 框 架 有 很 多 ， 不 过 出 现 最 早 且 最 受 欢 迎 的 是 
Twitter 开发 的 Bootstrap。 我 们 就 使 用 这 个 框架 。 


Bootstrap 可 在 http://getbootstrap.com/ 获取 。 
下 载 Bootstrap， 把 它 放 在 lists 应 用 中 一 个 新 文件 夹 static 里 : 7 



































$ wget -0 bootstrap.zip https://github.com/twbs/bootstrap/releases/download/\ 
v3.3.4/bootstrap-3.3.4-dist.zip 

$ unzip bootstrap.zip 

$ mkdir lists/static 

$ mv bootstrap-3.3.4-dist lists/static/bootstrap 

$ rm bootstrap.zip 


dist 文件 夹 中 的 内 容 是 未 经 定制 的 原始 Bootstrap 框架 ， 现 在 使 用 这 些 内 容 ， 但 在 真正 的 网 





TAE 





站 中 不 能 这 么 做 ， 因 为 用 户 能 立即 看 出 你 使 用 Bootstrap 时 没有 定制 ， 业 内 人 士 也 能 由 此 
推 知 你 懒得 为 网 站 编写 样式 。 你 应 该 学 习 如 何 使 用 LESS， 至 少 把 字体 改 了 。Bootstrap X 
当中 有 定制 的 详细 说 明 ， 或 者 你 可 以 阅读 一 篇 名 为 “How to Customize Twitter's Bootstrap" 








的 指南 ， 写 得 还 不 错 。 
最 终 得 到 的 lists 文件 夹 结构 如 下 : 


$ tree lists 
lists 

l— init .py 
l— | pycache . 
| — E... 
|I— admin.py 
HF models.py 
|l— static 


| — bootstrap 














: 在 Windows 中 不 能 使 用 wget 和 unzip， 但 我 相信 你 知道 如 何 下 载 Bootstrap， 解 压缩 ， 再 把 dist 文件 夹 























中 的 内 容 移 到 lists/static/bootstrap 文件 夹 中 。 
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[— bootstrap.css 
I— bootstrap.css.map 
[— bootstrap.min.css 
[— bootstrap-theme.css 
[— bootstrap-theme.css.map 
— bootstrap-theme.min.css 
— fonts 
I— glyphicons-halflings-regular.eot 
I— glyphicons-halflings-regular.svg 
I— glyphicons-halflings-regular.ttf 
I— glyphicons-halflings-regular.woff 
L glyphicons-halflings-regular.woff2 
L— ds 
I— bootstrap.js 
I— bootstrap.min.js 
I— npm.js 
| 一 templates 
[— home .htmL 
—— list.html 
| 一 tests.py 


| urls.py 


— views.py 














在 Bootstrap 文档 中 的 “Getting Started” 部 分 ， 你 会 发 现 Bootstrap 要 求 HTML 模板 中 包含 
如 下 代码 : 


<!DOCTYPE html» 
«html» 
«head» 
«meta charset-"utf-8"» 
«meta http-equivz"X-UA-Compatible" content-"IE-edge"» 
«meta name-"viewport" content-"widthzdevice-width, initial-scale-1"» 
«title»Bootstrap 101 Template«/title- 





«!-- Bootstrap --» 

«link hrefz"css/bootstrap.min.css" rel-"stylesheet"» 
</head> 
<body> 


<h1>Hello, world!</h1> 
<script src="http://code.jquery.com/jquery.js"></script> 
<script src="js/bootstrap.min.js"></script> 
</body> 
</html> 


我 们 已 经 有 两 个 HTML 模板 了 ， 所 以 不 想 在 每 个 模板 中 都 添加 大 量 的 样板 代码 。 这 似乎 是 
运用 “不 要 自我 重复 ”原则 的 好 时 机 ， 可 以 把 通用 代码 放 在 一 起 。 谢 天 谢 地 ，Django 使 用 
的 模板 语言 可 以 轻易 做 到 这 一 点 ， 这 种 功能 叫 作 “模板 继承 ”。 


8.3 ”Django 模板 继承 


看 一 下 home.html £l list.html 之 间 的 差异 : 


$ diff lists/templates/home.html lists/templates/list.html 
« «hi»Start a new To-Do list«/hi» 
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«form method="POST" action-"/lists/new"» 


| ^ 
1 


<h1>Your To-Do list«/hi» 
«form method="POST" action-"/lists/(( list.id jj/add item" 


«table id-"id list table" 
(* for item in list.item set.all X) 
<tr><td>{{ forloop.counter 3): {{ item.text }}</td></tr> 
{% endfor %} 
</table> 


这 两 个 模板 头 部 显示 的 文本 不 一 样 ， 而 且 表单 的 提交 地 址 也 不 同 。 除 此 之 外 ，1listhtml 还 
多 了 一 个 «table» 元 素 。 


现在 我 们 弄 清 了 两 个 模板 之 间 共 通 以 及 有 差异 的 地 方 ， 然 后 就 可 以 让 它们 继承 同一 个 父 级 
模板 了 。 先 复制 home.html: 


$ cp lists/templates/home.html lists/templates/base.html 


把 通用 的 样板 代码 写 入 这 个 基 模 板 中 ， 而 且 标 记 出 各 个 “ 块 "， 块 中 的 内 容留 给 子 模板 定制 |: 


V V V V VraN V 








lists/templates/base.html 


«html» 
«head» 
«title»To-Do lists«/title» 
</head> 


<body> 
<h1>{% block header_text %}{% endblock %}</h1> 
<form method="POST" action="{% block form action %}{% endblock %}"> 
<input name="item_text" id="id_new_item" placeholder="Enter a to-do item" /> 
{% csrf_token %} 
</form> 
{% block table %} 
{% endblock %} 
</body> 
</html> 


基 模 板 定 义 了 多 个 叫 作 “ 块 ”的 区 域 ， 其 他 模板 可 以 在 这 些 地 方 插入 自己 所 需 的 内 容 。 在 
实际 操作 中 看 一 下 这 种 机 制 的 用 法 。 修 改 home.html， 让 它 继承 base.html : 














lists/templates/home.html 
{% extends 'base.html' %} 


{% block header text X)Start a new To-Do list{% endblock %} 
{% block form action %}/lists/new{% endblock %} 


可 以 看 出 ， 很 多 HTML 样板 代码 都 不 见 了 ， 只 需 集 中 精力 编写 想 定 制 的 部 分 。 然 后 对 
list.html 做 同样 的 修改 : 
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lists/templates/list.html 
(* extends 'base.html' X) 


{% block header text %}Your To-Do list{% endblock %} 
{% block form action %}/lists/{{ list.id j3)/add item(* endblock %} 


(* block table %} 
«table id-"id list table" 
{% for item in list.item set.all X) 
<tr><td>{{ forloop.counter }}: {{ item.text )j«/td»«/tr» 
{% endfor %} 
</table> 
{% endblock %} 


对 模板 来 说 ， 这 是 一 次 重 构 。 再 次 运行 功能 测试 ， 确 保 设 有 破坏 现 有 功能 
AssertionError: 107.0 != 512 within 10 delta 

果然 ， 结 果 和 修改 前 一 样 。 这 次 改动 值得 做 一 次 提交 : 
$ git diff -b 
* -b 的 意思 是 忽略 空白 ， 因 为 我 们 修改 了 HTML 代 码 
$ git status 


$ git add lists/templates # 人 先 不 添加 static 文 件 夹 
$ git commit -m "refactor templates to use a base template" 


8.4 集成 Bootstrap 
现在 集成 Bootstrap 所 需 的 样板 代码 更 容易 了 ， 不 过 和 暂时 不 需要 JavaScript， 只 加 入 CSS 即 可 : 
































g 





的 一 些 缩 进 ， 所 以 有 必要 使 用 这 个 旗 标 








lists/templates/base.html (ch081006) 


<!DOCTYPE html» 
«html lang="en"> 


«head» 
«meta charset-"utf-8"» 
«meta http-equiv-"X-UA-Compatible" content-"IE-edge"- 
«meta name-"viewport" content-"widthzdevice-width, initial-scale-1"» 
«title»To-Do lists«/title- 
«link hrefz"css/bootstrap.min.css" rel-"stylesheet"» 

</head> 

[521 


行 和 列 


最 后 ， 使 用 Bootstrap 中 某 些 真正 强大 的 功能 。 使 用 之 前 你 得 先 阅读 Bootstrap 的 文档 。 可 
以 使 用 栅 格 系统 和 text-center 类 实现 所 需 的 效果 : 

















lists/templates/base.html (ch081007) 


«body» 
«div class-"container"» 


«div class="row"> 
«div class-"col-md-6 col-md-offset-3"> 
«div class-"text-center"» 
<h1>{% block header text %}{%  endblock %}</h1> 
«form method="POST" action="{% block form action %}{% endblock %}"> 
«input name="item text" id-"id new item" 
placeholder-"Enter a to-do item" /> 
(X csrf token %} 
</form> 
</div> 
</div> 
</div> 


<div class="row"> 
<div class="col-md-6 col-md-offset-3"> 
{% block table %} 
{% endblock %} 
</div> 
</div> 


</div> 
</body> 


(如 果 你 从 来 没有 把 一 个 HTML 标签 分 成 多 行 ， 可 能 会 觉得 上 述 «inputs 标签 有 点 儿 打破 
常规 。 这 样 写 完全 可 行 ， 如 果 你 不 喜欢 ， 可 以 不 这 么 写 。) 





如 果 你 从 未 看 过 Bootstrap 文档 ， 花 点 儿 时 间 浏 览 一 下 吧 。 文 档 中 介绍 了 很 多 
有 用 的 工具 ， 可 以 运用 到 你 的 网 站 中 。 








做 了 上 述 修改 之 后 ， 功 能 测试 能 通过 吗 ? 


AssertionError: 107.0 != 512 within 10 delta 


咽 ， 还 不 能 。 为 什么 没有 加 载 CSS 呢 ? 


8.5 ”Django 中 的 静态 文件 


Django 处 理 静 态 文 件 时 需要 知道 两 件 事 (其实 所 有 Web 服务 器 都 是 如 此 )。 


(1) 收 到 指向 某 个 URL 的 请 求 时 ， 如 何 区 分 请 求 的 是 静态 文件 ， 还 是 需要 经 过 视图 函数 
处 理 ， 生 成 HTML, 
(2) 到 哪里 去 找 用 户 请 求 的 静态 文件 。 


， 静 态 文件 就 是 把 URL 映射 到 硬盘 中 的 文件 上 。 
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为 了 解决 第 一 个 问题 ，Django 允许 我 们 定义 一 个 URL 前 级 ， 任 何以 这 个 前 缀 开头 的 URL 
都 被 视 作 针 对 静态 文件 的 请 求 。 默 认 的 前 级 是 /static/， 在 settings.py 中 定义 : 


superlists/settings.py 
[sad] 


# Static files (CSS, JavaScript, Images) 
# https://docs.djangoproject.com/en/1.11/howto/static-files/ 


STATIC URL = '/static/' 
后 面 在 这 一 部 分 添加 的 设置 都 和 第 二 个 问题 有 关 ， 即 在 硬盘 中 找到 真正 的 静态 文件 。 
既然 用 的 是 Django 开发 服务 器 (manage.py runserver)， 就 可 以 把 寻找 静态 文件 的 任务 交 
给 Django 完成 。Django 会 在 各 应 用 中 每 个 名 为 static 的 子 文件 夹 里 寻找 静态 文件 。 
现在 知道 把 Bootstrap 框架 的 所 有 静态 文件 都 放 在 lists/static 文件 夹 中 的 原因 了 吧 。 可 是 为 
什么 现在 不 起 作用 呢 ? 因为 没 在 URL 中 加 入 前 级 /static/。 再 看 一 下 base.html 中 链接 CSS 
的 元 素 : 


«link href-"css/bootstrap.min.css" rel="stylesheet"> 


若 想 让 这 行 代码 起 作用 ， 要 把 它 改 成 : 



























































lists/templates/base.html 
<link href="/static/bootstrap/css/bootstrap.min.css" rel="stylesheet"> 
现在 ， 开 发 服务 器 收 到 这 个 请 求 时 就 知道 请 求 的 是 静态 文件 ， 因 为 URL 以 /static/ 开头 。 
然后 ， 服 务 器 在 每 个 应 用 中 名 为 static 的 子 文 件 夹 里 搜寻 名 为 bootstrap/css/bootstrap.min.css 
的 文件 。 最 后 找到 的 文件 应 该 是 lists/static/bootstrap/css/bootstrap.min.css。 


如 果 和 手动 在 浏览 器 中 查看 ， 应 该 会 看 到 样式 起 作用 了 ， 如 图 8-2 所 示 。 











-oo To-Do lists - Mozilla Firefox 
| E To-Do lists [22] | 
€ [@ localhost:8000/lists/9, » € | [B> Google Q i 会 od 
Your To-Do list 
Enter a to-do item — 
1: Download bootstrap 
2: Explain static files 


3: Take a screenshot 
4: Finish chapter 7 





O- x Se 








82: 网 站 开始 变 得 有 点 好 看 了 





116 | 第 8 章 


m8: 





iai HMM MN 


Ab. X 


EMAEMA 


AssertionError: 107.0 != 512 within 10 delta 


这 是 因为 ， 


虽然 runserver 启动 的 开发 服务 器 能 自动 找到 静态 文件 ， 但 LiveServerTestCase 找 


不 到 。 不 过 无 须 担 , 心 ，Django 为 开发 者 提供 了 一 个 更 神奇 的 测试 类 ，M StaticLiveServerTestCase, 





下 面 换 用 这 











QQ -1, 


-from 
*from 
from 
from 
from 


文 个 测试 类 : 


functional tests/tests.py 


14 +1,14 @@ 

django.test import LiveServerTestCase 
django.contrib.staticfiles.testing import StaticliveServerTestCase 
selenium import webdriver 

selenium.common.exceptions import WebDriverException 
selenium.webdriver.common.keys import Keys 


import time 


MAX WAIT - 10 


-class NewVisitorTest(LiveServerTestCase): 
*class NewVisitorTest(StaticLiveServerTestCase): 


def setUp(self): 


现在 测试 能 


找到 CSS 了 ， 因 此 视 试 也 能 通过 了 : 





$ python manage.py test functional_tests 
Creating test database for alias 'default'... 


Ran 3 





KHT! 


tests in 9.764s 


Windows 用 户 在 这 里 可 能 会 看 到 一 些 错 误 消息 (无 关 紧要 ,但 容易 让 人 分 
() : socket.error: [WinError 10054] An existing connection was forcibly 
closed by the remote host ( 现 有 连接 被 远程 主机 强制 关闭 )。 在 tearDown 77 
法 的 self.browser.quit() 之 前 加 上 self.browser.refresh() 就 能 去 掉 这 些 
错误 。Django 的 追踪 系统 正在 关注 这 个 问题 。 








8.6 ”使 用 Bootstrap 中 的 组 件 改进 网 站 外 观 


看 一 下 使 用 Bootstrap 百宝箱 中 的 其 他 工具 能 否 进一步 改善 网 站 的 外 观 。 
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8.6.1 超大 文本 块 


Bootstrap 中 有 个 类 叫 jumbotron， 用 于 特别 突出 地 显示 页 面 中 的 元 素 。 使 用 这 个 类 放大 显 
示 页 面 的 主 头 部 和 输入 表单 : 


lists/templates/base.html (ch081009) 


«div class-"col-md-6 col-md-offset-3 jumbotron"» 
«div class-"text-center"» 
<h1>{% block header text %}{% endblock *j«/hi» 
«form method="POST" action-"(X block form action %}{% endblock %}"> 
Ls] 


调整 网 页 的 设计 和 布局 时 ， 可 以 打开 一 个 浏览 器 窗口 ， 时 不 时 地 刷新 页 面 。 
执行 python manage.py runserver 命令 启动 开发 服务 器 ， 然 后 在 浏览 器 中 访问 
http://localhost:8000， 边 改 边 看 效果 。 





8.6.2 ”大 型 输入 框 


超大 文本 块 是 个 好 的 开始 ， 不 过 和 其 他 内 容 相 比 ， 输 入 框 显得 太 小 。 垃 好 Bootstrap 为 表单 
控件 提供 了 一 个 类 ， 可 以 把 输入 框 变 大 : 

















lists/templates/base.html (ch081010) 


«input name="item text" id-"id new item" 
class-"form-control input-lg" 
placeholder-"Enter a to-do item" /> 


8.6.83 样式 化 表格 


现在 表格 中 的 文字 和 页 面 中 的 其 他 文字 相 比 也 很 小 ， 加 上 Bootstrap 提供 的 table 类 可 以 改 


进 显示 效果 : 

















lists/templates/list.html (ch081011) 
«table id-"id list table" class="table"> 


8.7 ”使 用 自己 编写 的 CSS 


最 后 ， 我 想 让 输入 表单 离 标题 文字 远 一 点 儿 。Bootstrap 没有 提供 现成 的 解决 方案 ， 那 么 就 
自己 实现 吧 ， 引 入 一 个 自己 编写 的 CSS 文件 : 











lists/templates/base.html 
[ 


«title»To-Do lists</title> 

«link hrefz"/static/bootstrap/css/bootstrap.min.css" rel-"stylesheet"-» 
«link hrefz"/static/base.css" rel-"stylesheet"- 

</head> 





新 建文 件 lists/static/base.css， 写 入 自己 编写 的 CSS 新 规则 。 使 用 输入 框 的 id (id new item) 
定位 元 素 ， 然 后 为 其 编写 样式 : 























lists/static/base.css 


itid new item { 
margin-top: 2ex; 





} 
虽然 要 多 操作 几 步 ， 不 过 效果 很 让 我 满意 (如 图 8-3). 
To-Do lists - Mozilla Firefox x 
File Edit View History Bookmarks Tools Help 
| E To-Do lists E3] 
| € [@ localhost:s000/list: » € | 图 - Google Q L Axa 
Your To-Do list 
Enter a to-do item 
1: Collect chapters of TDD book 
2: 
3: Profit! 
| 加 x 8 € 














图 8-3: 清单 页 面 ， 各 部 分 都 显示 得 很 大 


如 果 想 进一步 定制 Bootstrap， 需 要 编译 LESS。 我 强烈 推荐 你 花 时 间 定 制 ， 总 有 一 天 你 会 

有 这 种 需求 。LESS、Sass 等 其 他 伪 CSS 类 工具 ， 对 普通 的 CSS 做 了 很 大 改进 ， 即 便 不 

使 用 机 也 很 有 用 。 我 不 会 在 这 本 书 中 介绍 LESS， 网 上 有 很 多 参考 资料 ， 比 如 说 
“How to Customize Twitter's Bootstrap” , 


最 后 再 运行 一 次 功能 济 试 ， 看 一 切 是 否 仍 能 正常 运 


$ python manage.py test functional_tests 
[...] 




















Ran 3 tests in 10.084s 
OK 


样式 化 暂 告 段落 。 现 在 是 提交 的 绝 好 时 机 : 
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$ git status # 修改 了 tests.py、base.html 和 list.html， 未 跟踪 lists/static 
$ git add . 
$ git status # 会 显示 添加 了 所 有 Bootstrap 相 关 文 件 


$ git commit -m "Use Bootstrap to improve layout" 


8.8 补遗 : collectstatic 命 令 和 其 他 静态 目录 


前 文 说 过 ，Django 的 开发 服务 器 会 自动 在 应 用 的 文件 夹 中 查找 并 呈现 静态 文件 。 在 开发 
过 程 中 这 种 功能 不 错 ， 但 在 真正 的 Web 服务 器 中 ， 并 不 需要 让 Django 伺服 静态 内 容 ， 因 
为 使 用 Python 伺服 原始 文件 速度 慢 而 且 效 率 低 ，Apache、Nginx 等 Web 服务 器 能 更 好 
地 完成 这 项 任务 。 或 许 你 还 会 决定 把 所 有 静态 文件 都 上 传 到 CDN (Content Distribution 
Network， 内 容 分 发 网 络 ) ， 不 放 在 自己 的 主机 中 。 


鉴于 此 ， 要 把 分 散在 各 个 应 用 文件 夹 中 的 所 有 静态 文件 集中 起 来 ， 复 制 一 份 放 在 一 个 位 
置 ， 为 部 署 做 好 准备 。collectstatic 命令 的 作用 就 是 完成 这 项 操作 。 
静态 文件 集中 放置 的 位 置 由 settings.py 中 的 STATIC_ROOT 定义 。 下 一 章 会 做 些 部 署 工作 ， 


现在 就 试 着 设置 一 下 吧 。 把 STATIC ROOT 的 值 设 为 仓库 之 外 的 一 个 文件 夹 一 一 我 要 使 用 和 
主 源码 文件 夹 同 级 的 一 个 文件 夹 : 









































workspace 

| superlists 

[I— lists 

| [I— models.py 
| 


ļ— manage.py 
I— superlists 


| 六 static 
| 一 base.css 


六 etc... 
关键 在 于 ， 静 态 文件 所 在 的 文件 夹 不 能 放 在 仓库 中 
为 其 中 的 文件 和 lists/static 中 的 一 样 。 


下 面 是 指定 这 个 文件 夹 位 置 的 一 种 优雅 方式 ， 路 径 相 对 settings.py 文件 而 言 : 

















不 想 把 这 个 文件 夹 纳入 版 本 控制 ， 


























super lists/settings.py (ch081018) 


4 Static files (CSS, JavaScript, Images) 
# https://docs.djangoproject.com/en/1.11/howto/static-files/ 


STATIC URL = '/static/' 
STATIC ROOT = os.path.abspath(os.path.join(BASE DIR, '../static')) 


在 设置 文件 的 顶部 ， 你 会 看 到 定义 了 BASE_DIR 变量 。 这 个 变量 利用 file (这 是 Python 
内 置 的 变量 ， 特 别 有 用 ) ， 为 我 们 提供 了 很 大 的 便利 。 


下 面 执行 collectstatic 命令 试 试 : 



































-z 
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$ python manage.py collectstatic 

[2] 

Copying '/.../superlists/lists/static/bootstrap/css/bootstrap-theme.css' 
Copying '/.../superlists/lists/static/bootstrap/css/bootstrap.min.css' 


76 static files copied to '/.../static'. 


如 果 查 看 ../static， 会 看 到 所 有 的 CSS 文件 : 


$ tree ../static/ 
../static/ 

I— admin 

I— css 

| bL base.css 


T 





L— xregexp.min.js 
[— base.css 
— bootstrap 
|— css 
[— bootstrap.css 
[— bootstrap.css.map 
I— bootstrap.min.css 
I— bootstrap-theme.css 
I— bootstrap-theme.css.map 
— bootstrap-theme.min.css 
I— fonts 
I— glyphicons-halflings-regular.eot 
I— glyphicons-halflings-regular.svg 
glyphicons-halflings-regular.ttf 
glyphicons-halflings-regular.woff 
glyphicons-halflings-regular.woff2 








L— ds 
[— bootstrap.js 
I— bootstrap.min.js 
— npm.js 





14 directories, 76 files 

















collectstatic 命令 还 收集 了 管理 后 台 的 所 有 CSS 文件 。 管 理 后 台 是 Django 的 强大 功能 
一 ， 总 有 一 天 我 们 要 知道 它 的 全 部 功能 。 但 现在 还 不 准备 用 ， 所 以 暂且 禁用 : 























superlists/settings.py 


INSTALLED APPS - [ 
&'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'lists', 
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然后 再 执行 collectstatic 试 试 : 


$ rm -rf ../static/ 
$ python manage.py collectstatic --noinput 
Copying '/.../superlists/lists/static/base.css' 


Lz] 
Copying '/.../superlists/lists/static/bootstrap/css/bootstrap-theme.css' 
Copying '/.../superlists/lists/static/bootstrap/css/bootstrap.min.css' 


15 static files copied to '/.../static'. 
好 多 了 。 
总 之 ， 现 在 知道 了 怎么 把 所 有 静态 文件 都 聚集 到 一 个 文件 夹 中 ， 这 样 Web 服务 器 就 能 轻易 
找到 静态 文件 。 下 一 章 会 深入 介绍 这 个 功能 和 测试 方法 。 
现在 ， 先 提交 settings.py 中 的 改动 : 


$ git diff # 会 看 到 settings .py 中 的 改动 
$ git commit -am "set STATIC_ROOT in settings and disable admin" 


8.9 没 谈 到 的 话题 

本 章 只 简单 介绍 了 样式 化 和 CSS， 有 一 些 话题 我 本 想 涉 及 ， 但 没 做 到 。 你 可 以 进一步 研究 
以 下 话题 。 

。 使 用 LESS 或 Sass 定制 Bootstrap。 

。 使 用 { static %} 模板 标签 ， 这 样 做 更 符合 DRY 原则 ， 也 不 用 硬 编码 URL, 

。 客户 端 打 包工 具 ， 例 如 npm 和 bower, 




















简单 来 说 ， 不 应 该 为 设计 和 布局 编写 测试 。 因 为 这 太 像 是 测试 常量 ， 所 以 写 出 的 测试 
不 太 牢靠 。 

这 说 明 设计 和 布局 的 实现 过 程 极 具 技 巧 性 ， 涉 及 CSS 和 静态 文件 。 因 此 ， 可 以 编写 一 
些 简 单 的 “ 冒 烟 测试 >， 确认 静态 文件 和 CSS 起 作用 即 可 。 下 一 章 我 们 会 看 到 ， 把 代 
码 部 署 到 生产 环境 时 ， 冒 烟 测 试 能 协助 我 们 发 现 问题 。 

但 是 ， 如 果 某 部 分 样式 需要 很 多 客户 端 JavaScript 代码 才能 使 用 (我 花 了 很 多 时 间 实 
现 动态 缩放 ) ， 就 必须 为 此 编写 一 些 测 试 。 

要 试 着 编写 最 简 的 测试 ， 确 信 设 计 和 布局 能 起 作用 即 可 ， 不 必 测 试 具 体 的 实现 。 我 们 
的 目标 是 能 自由 修改 设计 和 布局 ， 且 无 须 时 不 时 地 调整 测试 。 
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使 用 过 渡 网 站 测试 部 团 





“所 有 乐趣 都 在 部 署 到 生产 环境 之 前 。 
—— Devops Borat 


是 时 候 发 布 网 站 的 首 个 版 本 让 公众 使 用 了 。 人 们 常 说 ， 如 果 等 到 一 切 就 绪 再 发 布 ， 等 待 的 
时 间 就 太 长 了 。 

我 们 的 网 站 有 用 吗 ? 是 不 是 比 没有 要 好 ? 能 在 这 个 网 站 上 创建 待 办 事项 清单 吗 ? 这 三 个 疑 
回 的 答案 都 是 肯定 的 。 

可 是 ， 现 在 还 无 法 登录 ， 也 无 法 把 任务 标记 为 已 完成 。 不 过 你 真 的 需要 这 些 功 能 吗 ? 不 一 
定 ， 因 为 你 永远 也 不 知道 用 户 真正 想 使 用 你 的 网 站 做 什么 。 我 们 觉得 用 户 应 该 想 使 用 这 个 
网 站 制定 待 办 事项 清单 ， 但 他 们 真正 想 编写 的 或 许 是 一 个 “十 佳 假 蝇 钓 鱼 地 ”列表 ， 因 此 
就 不 用 提供 “标记 为 已 完成 ”功能 。 在 发 布 之 前 ， 我 们 永远 不 知道 用 户 的 真实 需求 。 

本 章 会 详细 介绍 如 何 把 网 站 部 署 到 真实 的 线 上 Web 服务 器 中 。 

你 可 能 想 跳 过 这 一 章 ， 因 为 本 章 有 很 多 令 人 生 展 的 知识 ， 或 许 还 觉得 部 署 不 是 你 阅读 本 书 
的 初 囊 。 但 是 我 强烈 建议 你 读 一 下 。 本 章 是 我 最 满意 的 内 容 之 一 ， 而 且 有 很 多 读者 写 信 说 
很 庆幸 自己 当时 克服 困难 读 完了 这 一 章 。 

如 果 你 以 前 从 未 把 网 站 部 署 到 服务 器 上 ， 读 过 本 章 后 会 发 现 一 片 新 大 陆 ， 而 且 没有 什么 能 
比 看 到 自己 的 网 站 在 真正 的 互联 网 中 上 线 更 令 人 满足 的 了 。 如 果 你 还 迟疑 ， 现 今 流行 的 术 
语 ， 比 如 “开发 运 维 ”(DevOps)， 一 定 能 让 你 相信 ， 花 时 间 学 习 部 署 是 值得 的 。 



































尔 的 网 站 上 线 后 请 写 封 信 告 诉 我 网 址 。 收 到 这 样 的 来 信 ， 我 的 心里 总 是 感觉 
上 暧 暧 的 。 我 的 电子 邮件 地 址 是 obeythetestinggoat? gmail.com, 
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9.1 TDD 以 及 部 署 的 危险 区 域 





把 网 站 部 署 到 线 上 Web 服务 器 是 个 很 复杂 的 过 程 。 我 们 经 常会 听 到 这 样 





误 苗 的 抱 忽 :“ 但 


PAD 





在 我 的 设备 中 可 以 正常 运行 啊 ! ” 
部 署 过 程 中 的 一 些 危 险 区 域 如 下 。 








静态 文件 (CSS、JavaScript、 图 片 等 ) 
Web 服务 器 往往 需要 特殊 的 配置 才能 伺服 静态 文件 。 








数据 库 
可 能 会 遇 到 权限 和 路 径 问 题 ， 还 要 小 心 处 理 ， 在 多 次 部 署 之 间 不 能 丢失 数据 。 
依赖 


要 保证 服务 器 上 安装 了 网 站 依赖 的 包 ， 而 且 版 本 要 正确 。 





不 过 这 些 问 题 都 有 相应 的 解决 方案 。 下 面 一 一 说 明 。 











使 用 与 生产 环境 一 样 的 基础 架构 部 署 过 渡 网 站 (staging site) ， 这 么 做 可 以 测试 部 署 的 过 
程 ， 确 保 部 署 真 正 的 网 站 时 操作 正确 。 
可 以 在 过 渡 网 站 中 运行 功能 测试 ， 确 保 服务 器 中 安装 了 正确 的 代码 和 依赖 包 。 而 且 为 了 
测试 网 站 的 布局 ， 我 们 编写 了 冒 烟 测试 ， 这 样 就 能 知道 是 否 正确 加 载 了 CSS。 
与 在 本 地 设备 上 一 样 ， 当 服务 器 上 运行 多 个 Python 应 用 时 ， 可 以 使 用 虚拟 环境 管理 包 
oss 

， 一 切 操作 都 自动 化 完成 。 使 用 自动 化 脚本 部 署 新 版 本 ， 使 用 同一 人 
D pu e E 尽 量 保证 过 渡 网 站 和 线 上 网 站 一 样 。 
































在 接 下 来 的 几 页 中 ， 我 会 详细 说 明 一 个 部 署 过 程 。 这 不 是 最 佳 的 部 署 过 程 ， 所 以 别 把 它 当 
作 最 佳 实践 ， 也 别 当 作 是 推荐 做 法 。 只 是 做 个 演示 ， 告 诉 你 部 署 过 程 涉及 哪些 问题 ， 以 及 








测试 在 这 个 过 程 中 的 作用 。 
内 容 提要 
接 下 来 的 三 章 内 容 很 多 ， 这 里 列 出 提要 ， 帮 助 你 理 清 思 路 。 





本 章 : 搭建 基础 环境 


。 修改 功能 测试 ， 以 便 在 过 渡 服 务 器 中 运行 。 

。 架设 服务 器 ,安装 所 需 的 全 部 软件 ,再 把 过 渡 和 线 上 环境 使 用 的 域名 指向 这 个 服务 器 . 

。 使 用 Git 把 代码 上 传 到 服务 器 。 

。 使 用 Django 开发 服务 器 在 过 渡 环 境 的 域名 下 尝试 运行 过 渡 网 站 。 

。 自己 动手 在 服务 器 上 搭建 虚拟 环境 (不 用 virtualenvwrapper), ， 确 保 数据 库 和 静态 
文件 都 能 使 用 。 











注 1: 我 称 之 为 “过 渡 ” 服 务 器 ， 有 人 了 叫 它 “ 开 发 ”服务 器 ， 还 有 人 叫 它 “ 预 备 生产 ” 服 务 器 。 不 管 叫 什么 ， 





目的 都 是 架设 一 个 尽量 和 生产 服务 器 一 样 的 环境 来 测试 代码 。 
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。 在 这 个 过 程 中 不 断 运行 功能 测试 ， 找 出 哪些 功能 可 以 正常 运行 ， 哪 些 不 能 。 

下 一 章 : 针对 生产 环境 配置 

。 修改 配置 ， 使 其 适应 生产 环境 : 不 再 使 用 Django 开发 服务 器 ， 让 应 用 在 引导 时 自 
动 启动 ， 把 DEBUG 设 为 FaLse， 等 等 。 

关于 部 署 的 第 三 章 : 自动 部 署 

(1) 配置 好 之 后 ， 编 写 一 个 脚本 ， 自 动 执 行 前 面 手动 完成 的 操作 ， 这 样 以 后 就 能 自动 部 
署 网 站 了 。 

(2) 最 后 ,使 用 自动 化 脚本 把 网 站 的 生产 版 本 部 署 到 真正 的 域名 下 。 











9.2 一 如 既往 ， 先 写 测 试 


稍微 修改 一 下 功能 测试 ， 让 它 能 在 过 渡 网 站 中 运行 。 添 加 一 个 参数 ， 指 定 测 试 所 用 的 临时 
服务 器 地 址 : 








functional tests/tests.py (ch081001) 
import os 
hel, 


class NewVisitorTest(StaticLiveServerTestCase): 


def setUp(self): 
self.browser = webdriver.Firefox() 
staging server = os.environ.get('STAGING SERVER') © 
if staging server: 
self.live server url = 'http://' + staging server 6 


还 记得 我 说 过 LiveserverTestCase 有 一 定 的 缺陷 吗 ? 其 中 一 个 缺陷 是 ， 它 总 是 假定 你 想 使 
用 它 自己 的 测试 服务 器 ， 这 个 服务 器 的 地 址 通过 self.live server url 获取 。 有 时 我 确实 
想 使 用 这 个 测试 服务 器 ， 但 也 想 有 别 的 选择 ， 比 如 使 用 一 个 真正 的 服务 器 。 


@ ”我 通过 环境 变量 STAGING_SERVER 决定 使 用 哪个 服务 器 。 
@ ”我 采用 的 措施 是 ， 把 self.live_server_url 替换 成 “真实 ”服务 器 的 地 址 。 
按照 “常规 的 ”方式 运行 功能 测试 ， 确 保 上 述 改动 没有 破坏 现 有 功能 : 














$ python manage.py test functional tests 
Ran 3 tests in 8.544s 
OK 


然后 指定 过 渡 服 务 器 的 URL 再 运行 试 试 。 我 要 使 用 的 过 渡 服 务 器 地 址 是 superlists-staging.ottg.eu : 
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$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 


FAIL: test can start a list for one user 
(functional tests.tests.NewVisitorTest) 
Traceback (most recent call last): 

File "/.../superlists/functional tests/tests.py", line 49, in 
test can start a list and retrieve it later 

self.assertIn('To-Do', self.browser.title) 

AssertionError: 'To-Do' not found in 'Domain name registration | Domain names 
| Web Hosting | 123-reg' 
[45x] 


FAIL: test multiple users can start lists at different urls 
(functional tests.tests.NewVisitorTest) 


Traceback (most recent call last): 

File 
"[...[superlists/functional tests/tests.py", line 86, in 
test layout and styling 

inputbox = self.browser.find element by id('id new item') 

Lsa] 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: [id-"id new item"] 


Es 


Traceback (most recent call last): 
File 
[...] 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: [id-"id new item"] 


[sa] 
Ran 3 tests in 19.480s: 
FAILED (failures-3) 


如 果 在 Windows 上 看 到 “STAGING_SERVER is not recognized as a command" 
这 样 的 错误 ， 可 能 是 因为 你 没 使 用 Git-Bash。 请 再 看 一 下 “准备 工作 和 应 具备 
的 知识 ”。 











可 以 看 到 ， 和 预期 一 样 ， 两 个 测试 都 失败 了 ， 因 为 我 还 没有 域名 呢 。 实 际 上 ， 从 第 一 个 调 
用 跟踪 中 可 以 看 出 ， 访 问 域名 注册 商 的 网 站 首页 时 测试 就 失败 了 。 


不 过 





， 看 起 来 功能 测试 的 测试 对 象 是 正确 的 ， 所 以 做 一 次 提交 吧 : 


$ git diff # 会 显示 functional_tests.py 中 的 改动 
$ git commit -am "Hack FT runner to be able to test staging" 
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别 使 用 export 设 定 STAGING SERVER 环境 变量 ， 否 则 在 当前 终端 里 运行 的 后 
续 测试 都 会 在 过 渡 网 站 中 运行 (如 果 这 跟 你 的 预期 不 一 样 ， 会 让 你 十 分 困 
惑 )。 最 好 在 每 次 运行 功能 测试 时 明确 设 定 。 








9.3 注册 域名 

读 到 这 里 ， 我 们 需要 广 册 几 个 域名 ， 不 过 也 可 以 使 用 同一 个 域名 下 的 多 个 二 级 域名 。 我 要 
使 用 的 域名 是 superlists.ottg.eu 和 superlists-staging.ottg.eu。 如 果 你 还 没有 域名 ， 现 在 就 得 
注册 一 个 。 再 次 说 明 ， 我 真 的 希望 你 按 我 所 说 的 做 。 如 果 你 从 未 注册 过 域名 ， 随 便 选 一 个 
老牌 注册 商 买 一 个 便宜 的 就 行 ， 只 要 花 5 美元 左右 ， 甚 至 还 能 找到 免费 域名 。 我 说 过 想 在 
真正 的 网 站 中 看 到 你 的 应 用 ， 这 或 许 能 推动 你 去 注册 一 个 域名 。 


9.4 手动 配置 托管 网 站 的 服务 器 


可 以 把 部 署 的 过 程 分 成 两 个 任务 。 


。 配置 新 服务 器 ， 用 于 托管 代码 。 
。 把 新 版 代码 部 署 到 配置 好 的 服务 器 中 。 


有 些 人 喜欢 每 次 部 署 都 用 全 新 服务 器 ， 我 们 在 PythonAnywhere 就 是 这 么 做 的 。 不 过 这 种 
做 法 只 适用 于 大 型 的 复杂 网 站 ， 或 者 对 现 有 网 站 做 了 重大 修改 。 对 我 们 这 个 简单 的 网 站 来 
说 ， 分 别 完 成 上 述 两 个 任务 更 合理 。 虽 然 最 终 这 两 个 任务 都 要 完全 自动 化 ， 但 就 目前 而 言 
或 许 更 适合 手动 配置 。 

在 阅读 过 程 中 ， 你 要 记 住 ， 配 置 的 过 程 各 异 ， 因 此 部 署 有 很 多 通用 的 最 佳 实践 。 所 以 ， 与 
其 尝试 记 住 我 的 具体 做 法 ， 不 如 试 着 理解 其 中 的 基本 原理 ， 这 样 以 后 你 遇 到 具体 问题 时 就 
能 使 用 相同 的 思想 解决 了 。 


9.4.1 选择 在 哪里 托管 网 站 

现今 ， 托 管 网 站 有 大 量 不 同 的 方案 ， 不 过 基本 上 可 以 归纳 为 两 类 。 

。 运行 自己 的 服务 器 (可 能 是 虚拟 服务 器 )。 

。 使 用 “平台 即 服务 ”(Platform-As-A-Service，PaaS) 提供 商 ， 例 如 Heroku、OpenShift 或 
PythonAnywhere, 


对 小 型 网 站 而 言 ，PaaS 的 优势 尤其 明显 ， 我 强烈 建议 你 考虑 使 用 PaaSs。 不 过 ， 基 于 几 个 
原因 ， 本 书 不 会 使 用 PaaS。 首 先 ， 有 利益 冲突 ， 我 觉得 PythonAnywhere 是 最 棒 的 ， 但 我 
这 么 说 是 因为 我 在 这 家 公司 工作 。 其 实 ， 各 家 Paas 提供 商 提 供 的 支持 各 不 相同 ， 部 署 的 过 
程 也 不 一 样 ， 所 以 学 会 其 中 一 家 的 部 署 方法 并 不 能 在 别家 使 用 。 任 何 一 家 提供 商都 有 可 能 
完全 修改 部 署 过 程 ， 或 者 当 你 阅读 这 本 书 时 已 经 停业 了 。 

因此 ， 我 们 要 学 习 一 些 优秀 的 老式 服务 器 管理 方法 ， 包 括 SSH 和 Web 服务 器 配置 。 这 些 
方法 永远 不 会 过 时 ， 而 且 学 会 这 些 方法 还 能 从 头发 花白 的 老 前 辈 那儿 得 到 一 些 尊重 。 
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我 要 试 着 搭建 一 个 十 分 类 似 于 Paas 环境 的 服务 器 ， 不 管 以 后 你 选择 哪 种 配置 方案 ， 都 能 
用 到 这 个 部 署 过 程 中 学 到 的 知识 。 


9.4.2 ”搭建 服务 器 

我 不 规定 你 该 怎么 搭建 服务 器 ， 不 管 你 选择 使 用 Amazon AWS, Rackspace x Digital 
Ocean， 还 是 自己 的 数据 中 心里 的 服务 器 ， 抑 或 楼 梯 后 橱柜 里 的 Raspberry Pi 一 一 哪 种 方案 
都 行 ， 只 要 满足 以 下 条 件 即 可 。 

。 服务 器 的 系统 使 用 Ubuntu16.04 (“Xenial/LTS”)。 

。 有 访问 服务 器 的 root 权限 。 

。 外 网 可 访问 。 

。 可 以 通过 SSH 登录 。 

我 推荐 使 用 Ubuntu 发 行 版 是 因为 其 中 安装 了 Python 3.6， 而 且 有 一 些 配 置 Nginx 的 特殊 方 
X (后 文 会 用 到 )。 如 果 你 知道 自己 在 做 什么 , 或 许可 以 换 用 其 他 发 行 版 ， 但 遇 到 问题 只 
能 靠 自己 了 。 

如 果 你 从 未 用 过 Linux 服务 器 ， 完 全 不 知道 从 何 处 入 手 ， 可 以 参照 我 在 GitHub 上 写 的 一 篇 简 
要 指南 (https://github.com/hjwp/Book-TDD-Web-Dev-Python/blob/master/server-quickstart.md)。 























有 些 人 阅读 本 章 时 会 跳 过 购买 域名 和 架设 真正 的 服务 器 这 两 部 分 ， 直 接 在 自 
己 的 电脑 中 使 用 虚拟 机 。 请 不 要 这 么 做 ， 这 两 种 方式 不 一 样 。 配 置 服务 器 本 
身 已 经 很 复杂 了 ， 如 果 用 虚拟 机 ， 阅 读本 章 的 内 容 时 会 遇 到 更 大 的 困难 。 如 
果 你 担心 要 花 钱 ， 可 以 四 处 找 找 ， 域 名 和 服务 器 都 有 免费 的 。 如 果 需 要 进 一 
步 指导 ， 可 以 给 我 发 电子 邮件 ， 我 一 直 都 乐于 助人 。 
































9.4.3 用 户 账 户 、SSH 和 权限 


本 市 假定 你 的 用 户 账户 没有 root 权限 ， 但 有 使 用 sudo 的 权限 ， 因 此 执行 需要 root 权限 的 
操作 时 ， 我 们 可 以 使 用 sudo。 在 下 面 的 说 明 中 ， 如 果 需 要 用 sudo， 我 会 指出 来 。 


我 使 用 的 用 户 名 是 “elspeth”， 你 可 以 根据 自己 的 喜好 起 名 。 























9.4.4 安装 Nginx 

我 们 需要 一 个 Web 服务 器 ， 既 然 现 在 酪 小孩 都 使 用 Nginx， 那 我 们 也 用 它 吧 。 我 和 Apache 
斗争 了 多 年 ， 可 以 说 单 就 配置 文件 的 可 读 性 这 一 项 而 言 ，Nginx 如 同 神 赐 般 拯 救 了 我 们 。 
在 我 的 服务 器 中 安装 Nginx 只 需 执 行 一 次 apt-get 命令 即 可 ， 然 后 再 执行 一 个 命令 就 能 
到 Nginx 默认 的 欢迎 页 面 : 


elspeth@server:$ sudo apt-get install nginx 
elspethüserver:$ sudo systemctl start nginx 


(你 可 能 要 先 执行 apt-get update 和 /或 apt-get upgrade,) 











注意 本 章 命令 行 代码 清单 中 的 elspeth@server， 它 表示 命令 必须 在 服务 器 中 
执行 ， 而 不 是 在 你 自己 的 电脑 中 执行 。 


现在 访问 服务 器 的 全 地 址 就 能 看 到 Nginx 的 “Welcome to nginx”( 欢 迎 使 用 Nginx) 页 
面 ， 如 图 9-1 所 示 。 








[d$ - c. Welcome tonginx!-Mozilla Firefox 





C3 welcome to nginx! [43] 


@ superlists-staging.ottg.eu » C | | 图 Google a 7 A Hr | 


Welcome to nginx! 


If you see this page, the nginx web server is successfully installed and working. 
Further configuration is required. 


For online documentation and support please refer to nginx.org. 
Commercial support is available at nginx.com. 


Thank you for using nginx. 











Smas ee 














E 9-1. Nginx 可 用 了 


如 果 没 看 到 这 个 页 面 ， 可 能 是 因为 防火 墙 没 有 开放 80 端口 。 以 AWS 为 例 ， 
你 可 能 得 配置 服务 器 的 “Security Group” 才 能 打开 80 端 





LI 


o 


9.4.5 ”安装 Python 3.6 


写作 本 书 时 ，Ubuntu 的 标准 仓库 中 还 没有 Python 3.6， 但 是 用 户 贡 献 的 “Deadsnakes PPA” 
中 有 。 


既然 我 们 有 root 权限 ， 下 面 就 来 安装 所 需 的 系统 级 关键 软件 : Python, Git, pip 和 


virtualenv , 














elspethüserver:$ sudo add-apt-repository ppa:fkrull/deadsnakes 
elspethüserver:$ sudo apt-get update 
elspethüserver:$ sudo apt-get install python3.6 python3.6-venv 


顺便 把 Git 也 安装 上 : 


elspeth@server:$ sudo apt-get install git 
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9.4.6 ”解析 过 渡 环境 和 线 上 环境 所 用 的 域名 


不 想 总 是 使 用 IP 地 址 ， 所 以 要 把 过 渡 环 境 和 线 上 环境 所 用 的 域名 解析 到 服务 器 上 。 我 的 广 


册 商 提供 的 控制 面板 如 图 9-2 所 示 。 





DNS ENTRY TYPE PRIORITY TTL DESTINATIONITARGET 
A 81.21.76.62 # 
A 81.21.76.62 # 
MX 10 mx0.123-reg.co.uk. # 
MX 20 mx1.123-reg.co.uk. # 
dev CNAME harry.pythonanywhere... uw 
WWW CNAME harry.pythonanywhere... E: d 
book-example A 82.196.1.70 uw 
book-example-staging A 82.196.1.70 wu 
A m" Add 











图 9-2. 解析 域名 











在 DNS 系统 中 ， 把 域名 指向 一 个 确切 的 IP 地 址 叫 作 “A 记录 "。 各 注册 商 提 供 的 界面 有 所 














不 同 ， 但 在 你 的 注册 商 网 站 中 四 处 点 击 几 次 应 该 就 能 找到 正确 的 页 





HI o 


9.4.7 ”使 用 功能 测试 确认 域名 可 用 而 且 Nginx 正 在 运行 











为 了 确认 一 切 顺利 ， 可 以 再 次 运行 功能 测试 。 你 会 发 现 失败 消息 稍 





个 消息 和 Neginx 有 关 A 


$ STAGING_SERVER=superlists-staging.ottg.eu python manage.py 


微 有 点 儿 不 同 ， 其 中 一 


test functional tests 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 


element: [id-"id new item"] 
[ses 


AssertionError: 'To-Do' not found in 'Welcome to nginx!' 


AER. HD TAE, RINIA, EDS vi DET. 


9.5 手动 部 署 代 码 





接着 要 让 过 渡 网 站 运行 起 来 ， 检 查 Nginx 和 Django 之 间 能 否 通信 。 从 这 一 步 起 ， 配 置 结 
束 了 ， 进 入 “部 署 ” 阶 段 。 在 部 署 的 过 程 中 ， 要 思考 如 何 自动 化 这 些 操作 。 








分 配置 阶段 和 部 署 阶段 有 个 经 验 法 则 : 配置 时 需要 root 权限 ， 但 部 署 时 不 


区 
需要 。 








需要 一 个 文件 夹 来 存放 源码 。 我 们 把 这 个 目录 放 在 一 个 非 root 用 户 的 家 目录 中 ， 在 我 的 
服务 器 中 ， 路 径 是 /home/elspeth (好 像 所 有 共享 主机 的 系统 都 是 这 么 设置 的 。 不 论 使 用 
什么 主机 ， 一 定 要 以 非 root 用 户 身份 运行 Web 应 用 )。 我 要 按照 下 面 的 文件 结构 存放 网 
站 的 代码 : 


/home/elspeth 
|— sites 
I— www .live.my-website.com 
[— database 

L— db.sqlite3 
I— source 
ļ— manage.py 
| 一 superLists 
|— etc... 














[— static 
| 一 base.css 
I— etc... 


— virtualenv 
|— lib 
I— etc... 
I— www .staging.my-website.com 
I— database 
I— etc... 


每 个 网 站 (过 渡 网 站 ， 线 上 网 站 或 其 他 网 站 ) 都 放 在 各 自 的 文件 夹 中 。 在 各 文件 夹 中 又 
有 单独 的 子 文件 夹 ， 分 别 存放 源码 、 数 据 库 和 静态 文件 。 采 用 这 种 结构 的 逻辑 依据 是 ， 
不 同 版 本 的 网 站 源码 可 能 会 变 ， 但 数据 库 始终 不 变 。 静 态 文件 夹 也 在 同一 个 相对 位 置 ， 
即 ../static， 前 一 章 末 尾 我 们 已 经 设置 好 了 。 最 后 ，virtualenv 也 有 自己 的 子 文件 夹 (在 
服务 器 上 无 须 使 用 virtualenvwrapper ， 我 们 将 动手 创建 虚拟 环境 )。 


9.5.1 调整 数据 库 的 位 置 
首先 ， 在 settings.py 中 修改 数据 库 的 位 置 ， 而 且 要 保证 修改 后 的 位 置 在 本 地 电脑 中 也 能 
使 用 : 


























superlists/settings.py (ch081003) 
# 项 目 内 的 路 径 使 用 os.path. join(BASE_DIR，...) 形 式 构建 
import os 
BASE DIR = os.path.dirname(os.path.dirname(os.path.abspath( file ))) 
[a] 
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DATABASES = { 
'default': { 
'ENGINE': 'django.db.backends.sqlite3', 
'NAME': os.path.join(BASE_DIR, '../database/db.sqlite3'), 











} 
} 
看 一 下 settings.py 文件 顶部 BASE_DIR 的 定义 。 注 意 ， 最 内 层 是 abspath。 
处 理 路 径 时 一 定 要 这 么 做 ， 否 则 导入 文件 时 会 遇 到 各 种 奇怪 的 问题 。 感 谢 
Green Nathan 指出 这 一 点 。 


$ mkdir ../database 

$ python manage.py migrate --noinput 

Operations to perform: 

Apply all migrations: auth, contenttypes, lists, sessions 
Running migrations: 

[1] 

$ ls ../database/ 

db.sqlite3 


看 起 来 可 以 正常 使 用 。 做 次 提交 : 











Mu Ix 





$ git diff # 会 看 到 settings.py 中 的 改动 
$ git commit -am "move sqlite database outside of main source tree" 





普 助 代码 分 享 网 站 ， 使 用 Git 把 代码 上 传 到 服务 器 。 如 果 之 前 设 推送 ， 现 在 要 把 代码 推送 
| GitHub, BitBucket 或 同类 网 站 中 。 这 些 网 站 都 为 初学 者 提供 了 很 好 的 用 法 说 明 ， 告 诉 





你 该 怎么 推送 。 
把 源码 上 传 到 服务 器 所 需 的 全 部 Bash 命令 如 下 所 示 。 如 果 你 不 熟悉 Bash 命令 ， 我 告诉 


你 ， 


export 的 作用 是 创建 一 个 可 在 bash 中 使 用 的 “本 地 变量 ”: 


elspethüserver:$ export SITENAME-superlists-staging.ottg.eu 
elspethüserver:$ mkdir -p -/sites/SSITENAME/database 

elspethüserver:$ mkdir -p -/sites/SSITENAME/static 

elspethüserver:$ mkdir -p -/sites/SSITENAME/virtualenv 

# 要 把 下 面 这 行 命 令 中 的 URL 换 成 你 自己 仓库 的 URL 

elspethüserver:$ git clone https://github.com/hjwp/book-example.git V 
^[sites/SSITENAME/source 

Resolving deltas: 100% [...] 





使 用 export 定义 的 Bash 变量 只 在 当前 终端 会 话 中 有 效 。 如 果 退 出 服务 器 后 
再 登录 ， 就 需要 重新 定义 。 这 个 特性 有 点 隐 星 ， 因 为 Bash 不 会 报错 ， 而 是 
直接 用 空 字符 串 表 示 未 定义 的 变量 ， 这 种 处 理 方式 会 导致 诡异 的 结果 。 如 果 
不 信 ， 可 以 执行 echo $SITENAME 试 试 。 








现在 网 站 安装 好 了 ， 在 开发 服务 器 中 运行 试 试 一 一 这 是 一 个 冒 烟 测 试 ， 检 查 所 有 活动 部 件 





是 否 连 接 起 来 了 : 
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elspethserver:$ $ cd -/sites/SSITENAME/source 
$ python manage.py runserver 
Traceback (most recent call last): 
File "manage.py", line 8, in «module» 
from django.core.management import execute from command line 
ImportError: No module named django.core.management 


啊 ， 服 务 器 上 还 没 安装 Django. 


9.5.2 ”手动 创建 虚拟 环境 ， 使 用 requirements.txt 


为 了 “保存 ”虚拟 环境 所 需 的 包 列 表 ， 也 为 了 能 够 重建 服务 器 ， 我 们 要 创建 requirements.txt 
文件 : 
$ echo "django--1.11" > requirements.txt 


$ git add requirements.txt 
$ git commit -m "Add requirements.txt for virtualenv" 


你 可 能 觉得 奇怪 ， 为 什么 没 在 需要 的 依赖 列表 中 添加 Selenium ? 这 是 因为 
Selenium 只 是 测试 的 依赖 ， 而 不 是 应 用 代码 的 依赖 。 有 些 人 喜欢 再 创建 一 个 
名 为 test-requirements.txt 的 文件 。 














现在 执行 git push 命令 ， 把 更 新 推送 到 代码 分 享 网 站 : 
$ git push 
然后 ， 把 改动 拉 取 到 服务 器 上 : 
elspeth@server:$ git pull # 可 能 会 让 你 先 对 git 做 些 配置 


车 想 手 动 创建 虚拟 环境 ( 即 不 使 用 virtualenvwrapper)， 就 要 使 用 标准 库 中 的 ven 模块 ， 
指定 虚拟 环境 的 存放 路 径 : 


elspeth@server:$ pwd 
/home/espeth/sites/staging.superlists.com/source 
elspeth@server:$ python3.6 -m venv ../virtualenv 
elspeth@server:$ ls ../virtualenv/bin 

activate activate.fish easy install-3.6 pip3 python 
activate.csh easy install pip pip3.6 python3 





如 果 想 激活 这 个 虚拟 环境 ， 就 执行 source ../virtualenv/bin/activate, 但 是 无 须 这 么 做 。 
其 实 ， 可 以 直接 调用 虚拟 环境 bin 目录 中 的 可 执行 文件 ， 运 行 相应 版 本 的 Python, pip 等 。 
稍 后 就 将 这 么 做 。 
为 了 把 所 需 的 依赖 安装 到 虚拟 环境 中 ， 使 用 虚拟 环境 中 的 pip: 
elspeth@server:$ ../virtualenv/bin/pip install -r requirements.txt 
Downloading/unpacking Django--1.11 (from -r requirements.txt (line 1)) 


[3] 
Successfully installed Django 
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为 了 运行 虚拟 环境 中 的 Python， 使 用 虚拟 环境 中 的 python 二 进 制 文件 : 


elspeth@server:$ ../virtualenv/bin/python manage.py runserver 
Validating models... 
0 errors found 


[...] 


如 果 防 火 墙 配置 得 当 ， 你 现在 甚至 可 以 手动 访 癌 网站。 你 要 执行 runserver 
0.0.0.0:80006， 监 听 外 网 和 内 网 卫 地 址 ， 然 后 访问 http:/your.domain.com:8000, 





看 起 来 能 正常 运行 。 按 Ctrl-C 键 停止 服务 器 。 

又 取得 了 进展 ! 现在 ， 我们 能 把 代码 推送 到 服务 器 上 (git push)， 也 能 从 服务 器 上 
拉 取 代码 (git puLL)。 而 且 我 们 搭建 了 一 个 与 本 地 一 致 的 虚拟 环境 ， 还 有 一 个 文件 
(requirements.txt) 同步 依赖 。 


接 下 来 将 配置 Nginx Web 服务 器 ， 让 它 与 Django 通信 ， 并 把 网 站 放 到 标准 的 80 端口 上 。 


9.5.3 简单 配置 Nginx 


下 面 创建 一 个 Nginx 配置 文件 ， 把 过 小 网 站 收 到 的 请 求 交 给 Django 处 理 。 如 下 是 一 个 极 
简 的 配置 。 











server: /etc/nginx/sites-available/superlists-staging.ottg.eu 


server { 
listen 80; 
server name superlists-staging.ottg.eu; 


location / { 
proxy. pass http://localhost:8000; 
} 
} 


这 个 配置 只 监听 过 渡 网 站 的 域名 ， 而 且 会 把 所 有 请 求 “代理 ”到 本 地 8000 端口 ， 等 待 
Django 处 理 请 求 后 得 到 的 响应 。 








我 把 这 个 配置 保存 为 superlists-staging.ottg.eu 文件 ， 放 在 /etc/nginx/sites-available 文件 夹 里 。 





不 知道 在 服务 器 中 如 何 编辑 文件 吗 ? 服务 器 中 都 有 vi， 我 建议 你 之 后 学 习 一 
下 如 何 使 用 这 个 工具 。 此 外 ， 也 可 以 使 用 对 初学 者 相对 友好 的 nano。 注 意 ， 
还 得 使 用 sudo， 因 为 这 个 文件 在 系统 文件 夹 中 。 











然后 创建 一 个 符号 链接 ， 把 这 个 文件 加 入 启用 的 网 站 列表 中 : 





elspethüserver:$ echo SSITENAME # 检查 在 这 个 shell 会 话 中 是 否 还 能 使 用 这 个 变量 获取 网 站 名 
superlists-staging.ottg.eu 

elspeth@server:$ sudo ln -s ../sites-available/SSITENAME /etc/nginx/sites- 
enabled/SSITENAME 

elspethüserver:$ ls -l /etc/nginx/sites-enabled # 确认 符号 链接 是 否 在 那里 





在 Debian 和 Ubuntu 中 ， 这 是 保存 Nginx 配置 的 推荐 做 法 一 一 把 真正 的 配置 文件 放 在 
sites-available 文件 夹 中 ， 然 后 在 sites-enabled 文件 夹 中 创建 一 个 符号 链接 。 这 么 做 便于 切 
换 网 站 的 在 线 状 态 。 
或 许 我 们 还 可 以 把 默认 的 “Welcome to nginx” 页 面 删除 ， 避 免 混 请 

elspeth@server:$ sudo rm /etc/nginx/sites-enabled/default 
现在 测试 一 下 配置 : 


elspeth@server:$ sudo systemctl reload nginx 
elspeth@server:$ ../virtualenv/bin/python manage.py runserver 





我 还 要 编辑 Jetc/nginx/nginx.conf 文件 ， 把 server names hash bucket size 64; 
这 行 的 注释 去 掉 ， 这 样 才 能 使 用 我 的 长 域名 。 你 或 许 不 会 遇 到 这 个 问题 。 执 行 
reload 命令 时 ， 如 果 配 置 文件 有 问题 ，Nsginx 会 提醒 你 。 














快速 进行 视觉 确认 一 一 网 站 运行 起 来 了 (如 图 9-3) | 

















To-Do lists - Mozilla Firefox (Private Browsing) © 
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图 9-3: 过 渡 网 站 运行 起 来 了 ! 





如 果 Nginx 出 现 异常 ， 执 行 sudo nginx -t 命令 试 试 。 这 个 命令 的 作用 是 测 
试 配置 ， 如 果 发 现 配置 文件 中 有 问题 ， 它 会 提醒 你 。 


T 
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我 们 来 看 功能 测试 的 结果 如 何 : 


$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 
[<] 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 


Ls] 

AssertionError: 0.0 !- 512 within 3 delta 
尝试 提交 新 待 办 事项 时 测试 失败 了 ， 因 为 还 没 设置 数据 库 。 运 行 测试 时 你 可 能 注意 到 了 
Django 的 黄色 报错 页 (At i 图 9-4 所 未 ， 手 动 访问 网 站 也 能 看 到 )， 页 面 中 显示 的 信息 和 测 
试 失败 消息 差不多 。 






































e a Ej DatabaseError at /lists/new - Mozilla Firefox 





| Ci Databasetrror at /lists/new [35] 


€ [& superlists-staging.ottg.eu/lists/new - Q| [Fl Google q i e X 


DatabaseError at /lists/new J 


no such table: lists_list 


Request Method: POST 
Request URL: http://localhost:8000/lists/new 
Django Version: 1.5.1 
Exception Type: DatabaseError 
Exception Value: ^o such tabte: lists list 
Exception Location: /home/harry/sites/superlists-staging.ottg.eu/virtualenv/lib/python3.3/site-packages/django 
/db/backends/sqlite3/base.py in execute, line 362 
Python Executable: /home/harry/sites/superlists-staging.ottg.eu/virtualenv/bin/python3 
Python Version: 3.3.1 
: ['/home/hi i: 7 t: -= E .eu/: "s 
Python Path: | /m/e tes/supertists-staging.ottg.eu/virtustenv/Lib/pythord.3*, 
' /hone/harry/sites/superlists-staging.ottg.eu/virtualenv/lib/python3.3/plat-x86 64-linux-gnu', 
'/hone/harry/sites/superlists-staging.ottg.eu/virtualenv/lib/python3.3/lib-dynload', 


'/usr/lib/python3.3', 
"Jusr/lib/python3.3/plat-x86 64-linux-gnu', 





* /hone/harry/sites/superlists-staging.ottg.eu/virtualenv/lib/python3.3/site-packages' ] 
Server time: Mon, 5 Aug 2013 10:49:12 -0500 





Traceback switch to copy-and-paste view 


/home/harry/sites/superlists-staging.ottg.eu/virtualenv/lib/python3.3/site-packages/django/core/handlers/base.py iN get response 
115. response = callback(request, *callback args, **callback kwargs) 


Pb Local vars 
O- x 9 


e 











图 9-4. 数据 库 还 无 法 使 用 





测试 避免 让 我 们 陷入 可 能 出 现 的 赛 境 之 中 。 访 问 网 站 首页 时 看 起 来 很 正常 ， 
如 果 此 时 草率 地 认为 工作 结束 了 ， 那 个 扰 人 的 Django 报错 页 就 会 被 网 站 的 
首 批 用 户 发 现 。 好 吧 ， 这 么 说 可 能 夸大 了 影响 ， 说 不 定 我 们 自己 已 经 发 现 
了 ， 可 是 如 采 网 站 越 来 越 大 、 越 来 越 复 杂 怎 么 办 ? 你 不 可 能 确认 每 项 功能 ， 
但 测试 能 。 


9.5.4 使 用 迁移 创建 数据 库 
执行 migrate 命令 时 ， 可 以 指定 --noinput 参数 ， 禁 止 两 次 询问 “你 确定 吗 ”: 


elspethüserver:$ ../virtualenv/bin/python manage.py migrate --noinput 
Creating tables ... 


Eos] 




















elspethQserver:$ ls ../database/ 
db.sqlite3 
elspethüserver:$ ../virtualenv/bin/python manage.py runserver 


再 运行 功能 测试 试 试 : 


$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 


Ran 3 tests in 10.718s 


OK 
看 到 网 站 运行 起 来 的 感觉 太 棒 了 ! 继续 阅读 下 一 节 之 前 ， 或 许 我 们 可 以 篇 车 自己 ， 喝 杯 茶 
休息 一 下 一 一 这 是 你 应 得 的 奖励 。 





如 果 看 到 “502 - Bad Gateway” 错 误 ， 可 能 是 因为 执行 migrate 命令 之 后 扎 
记 使 用 manage.py runserver 重启 开发 服务 器 。 


下 述 框 注 中 还 有 一 些 调试 技巧 。 





服务 器 调试 技巧 
部 署 是 个 业 手 活 儿 。 如 果 遇 到 问题 ， 可 以 使 用 以 下 技巧 找 出 原因 。 


。 我 知道 你 已 经 检查 过 了 ， 不 过 还 是 再 检查 一 遍 各 个 文件 ， 看 它们 的 位 置 和 内 容 是 否 
正确 。 哪 怕 只 错 一 个 字符 ， 也 可 能 导致 重大 问题 。 

。 查看 Nginx 的 错误 日 志 ， 存 储 在 /var/log/nginx/error.log 中 。 

。 可 以 使 用 -t 标志 检查 Nginx 的 配置 : nginx -t, 

。 确保 浏览 器 没有 缓存 过 期 的 响应 。 按 下 Cul 键 的 同时 点 击 刷新 按钮 ， 或 者 打开 一 个 
新 的 隐私 窗口 。 

。 最 后 ， 可 以 使 用 sudo reboot 彻底 重启 试 试 。 遇 到 无 从 下 手 的 问题 时 ， 我 有 时 就 是 
这 样 解决 的 。 


如 果真 的 遇 到 无 法 解决 的 问题 ， 还 可 以 推倒 重 来 。 第 二 次 肯定 顺手 得 多 ……, 


9.6 手动 部 署 大 功 告 成 


终于 结束 了 。 经 过 一 番 努 力 ， 我 们 让 网 站 运行 起 来 了 ， 至 少 基本 上 可 用 了 。 但 是 ， 在 生产 
环境 真 的 不 能 使 用 Django 开发 服务 器 ， 而 且 不 能 靠 手 动 执行 runserver 命令 启动 服务 器 。 
下 一 章 将 改进 部 署 过 程 ， 让 它 更 适用 于 生产 环境 。 
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测试 驱动 服务 器 配置 和 部 署 
测试 能 降低 部 署 过 程 的 不 确定 性 
对 开发 者 来 说 ， 管 理 服务 器 始终 充满 “乐趣 ”， 我 的 意思 是 ， 这 个 过 程 充满 不 确定 性 
和 意外 。 我 写 这 一 章 的 目的 是 告诉 你 ， 功 能 测试 组 件 能 降低 这 个 过 程 的 不 确定 性 。 
常见 的 痛 点 数据 库 、 静 态 文件 、 依 赖 、 自 定义 设置 
数据 库 配 置 、 静 态 文 件 、 软 件 依赖 和 自 定义 设置 在 开发 环境 和 生产 环境 之 间 有 所 不 
同 ， 部 署 时 要 格外 留意 。 自 己 部 署 时 ， 一定 要 审慎 处 理 这 些 事物 。 





有 测试 护航 ， 可 以 放心 试验 
改动 服务 器 配置 后 ， 可 以 运行 测试 组 件 ， 确 保 一 切 依然 正常 。 有 测试 的 保护 ， 我 们 
可 以 放心 试验 ， 少 一 分 担忧 (有 具体 内 容 参 见 下 一 章 )。 











第 10 章 


为 部 署 到 生产 环境 做 好 准备 





本 章 将 做 些 修改 ， 让 我 们 的 网 站 更 适应 生产 环境 的 配置 。 每 次 修改 都 将 通过 测试 确认 功能 
是 否 依然 可 用 。 


前 面 的 部 署 过 程 有 什么 问题 呢 ? 问题 在 于 ， 生 产 环境 不 能 使 用 Dijango 开发 服务 器 ， 而 且 
没有 考虑 到 “真实 的 ”负载 。 我 们 将 换 用 Gunicorn 运行 Django 代码， 并且 使 用 Neginx fs] 
服 静 态 文 件 。 


目前 的 settings.py 把 DEBUG 设 为 True， 我 极 不 推荐 在 生产 环境 这 么 做 (我 们 可 不 想 在 网 站 
出 错时 让 用 户 看 到 供 调 试 的 调用 跟踪 ) 。 安 全 起 见 ， 我 们 还 将 设 定 ALLOWED, HOSTS, 


我 们 希望 网 站 在 服务 器 重启 后 自动 启动 。 为 此 ， 我 们 将 编写 一 个 Systemd 配置 文件 。 


最 后 ， 把 网 站 绑 定 到 8000 端口 会 导致 无 法 在 服务 器 中 运行 多 个 网 站 ， 因 此 将 换 用 “unix 
ERT” M Nginx 和 Django, 


10.1 4d&RjGunicorn 


知道 为 什么 Django 的 吉祥 物 是 一 匹 小 马 吗 ? Django 提供 了 很 多 功能 ， 包 括 ORM、 各 种 
中 间 件 、 网 站 后 台 等 。 “除了 小 马 之 外 你 还 想 要 什么 呢 ? ”我 想 ， 既 然 你 已 经 有 一 匹 小 马 
了 ， 或 许 你 还 想 要 一 头 “ 绿 色 独 角 兽 ”(Green Unicorn), BU Gunicorn, 


elspeth@server:$ ../virtualenv/bin/pip install gunicorn 




















Gunicorn 需要 知道 WSGI (Web Server Gateway Interface, Web 服务 器 网 关 接 口 ) 服务 器 的 
路 径 。 这 个 路 径 往 往 可 以 使 用 一 个 名 为 application 的 函数 歼 取 。Django 在 文件 superlists/ 
wsgi.py 中 提供 了 这 个 函数 : 
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elspethéserver:$ ../virtualenv/bin/gunicorn superlists.wsgi:application 
2013-05-27 16:22:01 [10592] [INFO] Starting gunicorn 0.19.6 

2013-05-27 16:22:01 [10592] [INFO] Listening at: http://127.0.0.1:8000 (10592) 
[2] 


如 有 果 现 在 访问 网 站 ， 会 发 现 所 有 样式 都 失效 了 ， 如 图 10-1 所 示 。 
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10-1; 样式 失效 
如 果 运 行 功能 测试 ， 会 看 到 的 确 出 问题 了 。 添 加 待 办 事项 的 测试 能 顺利 通过 ， 但 布局 和 样 
式 的 测试 失败 了 。 测 试 做 得 不 错 ! 
$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 
[...] 


AssertionError: 125.0 != 512 within 3 delta 
FAILED (failures-1) 


样式 失效 的 原因 是 ，Django 开发 服务 器 会 自动 
置 Nginx， 让 它 代为 伺服 静态 文件 。 


我 们 前 进 了 一 步 ， 又 后 退 了 一 步 ， 不 过 有 测试 在 辅助 我 们 。 继 续 前 进 ! 


10.2 ”让 Nginx 伺 服 静 态 文 件 


首先 ， 执 行 collectstatic 命令 ， 把 所 有 静态 文件 复制 到 一 个 Nginx 能 找到 的 文件 夹 中 : 


3] 


司 服 静态 文件 ， 但 Gunicorn 不 会 。 现 在 配 




















elspethgserver:$ ../virtualenv/bin/python manage.py collectstatic --noinput 
elspethüserver:$ ls ../static/ 
base.css bootstrap 


下 面 配置 Nginx， 让 它 伺 服 静 态 文件 ; 


server { 
listen 80; 
server name superlists-staging.ottg.eu; 














location /static { 
alias /home/elspeth/sites/superlists-staging.ottg.eu/static; 
} 


location / { 
proxy_pass http://localhost:8000; 


J 
然后 重启 Nginx 和 Gunicorn: 


elspethüserver:$ sudo systemctl reload nginx 
elspethüserver:$ ../virtualenv/bin/gunicorn superlists.wsgi:application 


如 有 果 再 次 访问 网 站 ， 会 看 到 外 观 正常 多 了 。 可 以 再 次 运行 功能 测试 确认 : 


$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 
Ei 



































OK 


10.3 换 用 Unix 套 接 字 


如 果 想 要 同时 伺服 过 渡 网 站 和 线 上 网 站 ， 这 两 个 网 站 就 不 能 共用 8000 端口 。 可 以 为 不 同 
网 站 分 配 不 同 端口 ， 但 这 么 做 有 点 儿 随 意 ， 而 且 很 容易 出 错 ， 万 一 在 线 上 网 站 的 端口 上 启 
动 过 渡 服 务 器 (或 者 反 过 来 ) 怎么 办 。 

更 好 的 方法 是 使 用 Unix 域 套 接 字 。 域 套 接 字 类 似 于 硬盘 中 的 文件 ， 不 过 还 可 以 用 来 处 理 
Nginx 和 Gunicorn 之 间 的 通信 。 要 把 套 接 字 保 存在 文件 夹 /mp 中 。 下 面 修改 Nginx 的 代理 
设置 。 


























server: /etc/nginx/sites-available/superlists-staging.ottg.eu 


[...] 
location / { 
proxy set header Host Shost; 
proxy pass http://unix:/tmp/superlists-staging.ottg.eu.socket; 
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proxy, set header 的 作用 是 让 Gunicorn 和 Django 知道 它们 运行 在 哪个 域名 下 。ALLOWED_HOSTS 
安全 功能 需要 这 个 设置 ， 稍 后 会 局 用 这 个 功能 。 
现在 重启 Gunicorn， 不 过 这 一 次 告诉 它 监 听 套 接 字 ， 而 不 是 默认 的 端口 : 


elspethüserver:$ sudo systemctl reload nginx 
elspethüserver:$ ../virtualenv/bin/gunicorn --bind Y 
unix:/tmp/superlists-staging.ottg.eu.socket superlists.wsgi:application 


还 要 再 次 运行 功能 测试 ， 确 保 所 有 测试 仍 能 通过 : 


$ STAGING_SERVER=superlists-staging.ottg.eu python manage.py test functional tests 


[...] 
OK 


还 差 儿 步 才能 完成 部 署 。 


10.4 ”把 DEBUG 设 为 False， 设 置 ALLOWED_HOSTS 


在 自己 的 服务 器 中 开启 调试 模式 有 利于 排查 问题 ， 但 显示 满 页 的 调用 跟踪 不 安全 。 

在 settings.py 的 顶部 有 DEBUG 设置 项 。 如 果 把 它 设 为 False， 还 需要 设置 另 一 个 选项 ， 
ALLOWED_HOSTS。 这 个 设置 在 Django L5 中 添加 ， 目 的 是 提高 安全 性 。 不 过 ， 在 默认 的 
settings.py 中 没有 为 这 个 功能 提供 有 帮助 的 注释 。 那 就 自己 添加 这 个 选项 吧 ， 在 服务 器 中 
按照 下 面 的 方式 修改 settings.py。 



































Server: superlists/settings.py 





# 安全 警告 : 别 在 生产 环境 中 开启 调试 模式 | 
DEBUG = False 





TEMPLATE_DEBUG = DEBUG 


# DEBUG=False 时 需要 这 项 设置 
ALLOWED HOSTS = ['superlists-staging.ottg.eu'] 
[3] 


然后 重启 Gunicorn， 再 运行 功能 测试 ， 确 保 一 切 正 常 。 




















在 服务 器 中 别提 交 这 些 改动 。 现 在 这 只 是 为 了 让 网 站 正常 运行 做 的 小 调整 ， 
不 是 需要 纳入 仓库 的 改动 。 一 般 来 说 ， 简 单 起 见 ， 我 只 会 在 本 地 电脑 中 把 改 
动 提交 到 Git 仓库 中 。 如 果 需 要 把 代码 同步 到 服务 器 中 ， 再 使 用 git push 和 
git pull, 














再 次 运行 测试 ， 确 认 一 切 正 常 : 
$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 


OK 


很 好 。 





10.5 ”使 用 Systemd 确 保 引 导 时 启动 Gunicorn 


部 署 的 最 后 一 步 是 确保 服务 器 引导 时 自动 启动 Gunicorn， 如 果 Gunicorn 崩 涡 了 还 要 自动 重 
Ji. TE Ubuntu 中 ， 可 以 使 用 Systemd 实现 这 个 功能 。 


server: /etc/systemd/system/gunicorn-superlists-staging.ottg.eu.service 
[Unit] 
Description-Gunicorn server for superlists-staging.ottg.eu 


[Service] 

Restart-on-failure © 

Userzelspeth @ 

WorkingDirectory-z/home/elspeth/sites/superlists-staging.ottg.eu/source © 

ExecStart-/home/elspeth/sites/superlists-staging.ottg.eu/virtualenv/bin/gunicorn V 
--bind unix:/tmp/superlists-staging.ottg.eu.socket V 
superlists.wsgi:application OQ 


[Install] 
WantedBy-zmulti-user.target © 


Systemd 的 配置 很 简单 (如 果 曾 经 编写 过 init.d 脚本 ， 会 觉得 更 简单 ) miH—H T4. 
Q  Restart-on-failure 指明 在 崩溃 时 自动 重启 进程 。 
@ User=elspeth 指明 以 “elspeth” 用 户 的 身份 运行 进程 。 
© ”WorkingDirectory 设 定 当前 工作 目录 。 
@ ExecStart 是 要 执行 的 进程 。 为 了 提高 可 读 性 ， 我 们 使 用 行 接续 符 \ 把 整个 命令 分 成 多 行 ， 
不 过 也 可 以 写成 一 行 。 
© [Install] 区 中 的 WantedBy 告诉 Systemd， 我 们 想 在 引导 时 启动 这 个 服务 。 
Systemd 脚本 保存 在 /etc/systemd/system 中 ， 而 且 文 件 名 必须 以 .service 结尾 。 
下 面 告 诉 Systemd， 使 用 systemctl 命令 启动 Gunicorn: 
# 必须 执行 这 个 命令 ， 让 Systemd 加 载 新 的 配置 文件 
elspethüserver:$ sudo systemctl daemon-reload 
# 这 个 命令 让 Systemd 在 引导 时 加 载 服务 
elspeth(server:$ sudo systemctL enable gunicorn-superlists-staging.ottg.eu 


8 这 个 命令 启动 服务 
elspeth@server:$ sudo systemctl start gunicorn-superlists-staging.ottg.eu 




































































(顺便 说 一 下 ， 你 会 发 现 systemctl 命令 支持 按 制 表 符 补 全 ， 甚 至 可 以 补 全 服务 名 称 。) 
现在 可 以 再 次 运行 功能 测试 ， 确 保 一 切 仍 能 正常 运行 。 你 甚至 还 可 以 重启 服务 器 ， 查 看 网 

















站 能 否 自动 重新 运行 。 
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更 多 调试 技巧 
e 执行 sudo journalctl -u gunicorn-superlists-staging.ottg.eu 命令 查看 Systemd 的 
日 志 。 
。 可 以 让 Systemd 检查 服务 配置 是 否 有 效 : systemd-analyze verify /path/to/my.service, 
。 改动 后 记得 重启 相关 服务 。 
。 修改 Systemd 配置 文件 后 ， 如 果 想 查看 改动 的 效果 ， 要 在 执行 systemctL restart 
之 前 执行 daemon-reload 命令 。 











保存 改动 : 把 Gunicorn 添 加 到 requirements.txt 
回 到 本 地 仓库 ， 应 该 把 Gunicorn 添加 到 虚拟 环境 所 需 的 包 列 表 中 : 


$ pip install gunicorn 

$ pip freeze | grep gunicorn »» requirements.txt 

$ git commit -am "Add gunicorn to virtualenv requirements" 
$ git push 


写作 本 书 时 ， 在 Windows 中 使 用 pip 能 顺利 安装 Gunicorn, fH Gunicorn 无 法 
正常 使 用 。 幸 好 我 们 只 在 服务 器 中 使 用 Gunicom， 因 此 这 不 是 问题 。 不 过 ， 
对 Windows 的 支持 正在 讨论 中 。 














10.6 考虑 上 自动 化 


总 结 一 下 配置 和 部 署 的 过 程 。 
。 配置 
(1) 假设 有 用 户 账户 和 家 目录 。 
(2) add-apt-repository ppa:fkrull/deadsnakes, 
(3) apt-get install nginx git python3.6 pxthon3.6-venv, 
(4). 添加 Nginx 虚拟 主机 配置 。 
(5) 添加 Upstart 任务 ， 自 动 启动 Gunicorn。 
。 部 团 
(1) 在 ~/sites 中 创建 目录 结构 。 
(2) 拉 取 源码 ， 保 存 到 source 文件 夹 中 。 
(3) 启用 ../virtualenv 中 的 虚拟 环境 。 
(4) pip install -r requirements.txt, 
(5) 执行 manage.py migrate， 创 建 数据 库 。 
(6) 执行 collectstatic 命令 ， 收 集 静 态 文件 。 
(7) 在 settings.py 中 设置 DEBUG = False 和 ALLOWED_HOSTS。 
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(8) 重启 Gunicorn, 

(9) 运行 功能 测试 ， 确 保 一 切 正常 。 
假设 现在 不 用 完全 自动 化 配置 过 程 ， 应 该 怎么 保存 现 阶 段 取得 的 结果 呢 ? 我 说 应 该 把 
Nginx 和 Systemd 配置 文件 保存 起 来 ， 便 于 以 后 重用 。 下 面 把 这 两 个 配置 文件 保存 到 仓库 
中 一 个 新 建 的 子 文件 夹 中 。 


保存 配置 文件 的 模板 
首先 ， 创 建 这 个 子 文件 夹 : 
$ mkdir deploy tools 


下 面 是 Nginx 配置 的 通用 模板 : 





























7 











deploy _tools/nginx.template.conf 


server { 
listen 80; 
server_name SITENAME; 


location /static { 
alias /home/elspeth/sites/SITENAME/static; 


} 
location / { 


proxy_set_header Host $host; 
proxy pass http://unix:/tmp/SITENAME. socket; 


} 
fiz Gunicorn Systemd 服务 的 模板 : 





才 











deploy tools/eunicorn-systemd.template.service 


[Unit] 
Description-Gunicorn server for SITENAME 


[Service] 

Restart-on-failure 

Userzelspeth 

WorkingDirectory-/home/elspeth/sites/SITENAME/source 

ExecStart-/home/elspeth/sites/SITENAME/virtualenv/bin/gunicorn V 
--bind unix:/tmp/SITENAME.socket V 
superlists.wsgi:application 


[Install] 
WantedBy-zmulti-user.target 


再 使 用 这 两 个 文件 配置 新 网 站 就 容易 了 ， 查 找 替 换 SITENAME 即 可 。 
其 他 步骤 做 些 笔 记 就 行 。 为 什么 不 在 仓库 中 建 个 文件 保存 说 明 呢 ? 
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deploy tools/provisioning notes.md 
配置 新 网 站 


"B 需要 的 包 : 


nginx 

Python 3.6 
virtualenv + pip 
Git 


+O + + X 


以 Ubuntu 为 例 ， 


sudo add-apt-repository ppa:fkrull/deadsnakes 
sudo apt-get install nginx git python36 python3.6-venv 


38 Nginx 虚 拟 主机 


* 参考 nginx.template.conf 
* 把 SITENAME 替 换 成 所 需 的 域名 ， 例 如 staging.my-domain.com 


## Systemd 服 务 


* Z75gunicorn-upstart.template.conf 
* 把 SITENAME 杰 换 成 所 需 的 域名 ， 例 如 staging.my-domain.com 


HH 文件 夹 结构 : 
假设 有 用 户 账户 ， 家 目录 为 /home/username 








/home/username 
[一 sites 
L— SITENAME 
|l— database 
|l— source 
|l— static 


L— virtualenv 


然后 提交 上 述 改动 : 


$ git add deploy_tools 
$ git status # 看 到 3 个 新 文件 
$ git commit -m "Notes and template config files for provisioning" 





现在 ,源码 的 目录 结构 如 下 所 示 : 


FF deploy. tools 

HF gunicorn-systemd.template.service 
I— nginx.template.conf 

L— provisioning notes.md 

I— functional tests 

E—'E | 

|— lists 

— | init .py 

I— models.py 








EF 

— D 

| 一 base.css 

L— bootstrap 
F= Ded 

| 一 templates 

I— base.html 

mr. 

| 一 tests.py 

| urls.py 

-一 views.py 

一 manage.py 

| 一 requirements.txt 

— superlists 


= [1 








10.7 保存 进度 








在 过 渡 服 务 器 中 运行 功能 测试 ， 能 让 我 们 相信 网 站 确实 全 正常 运行 。 但 大 多 数 情况 下 ， 你 


并 不 想 在 真正 的 服务 器 中 运行 能 测试 。 为 了 不 让 我 们 的 劳动 付 之 东 流 ， 并 且 保 证 生产 服 
务 器 和 过 渡 服 务 器 一 样 外 E 正 常 运行 ， 要 让 部 署 的 过 程 可 重复 执行 。 


为 此 ， 我 们 需要 自动 化 。 这 是 下 一 章 的 话题 。 








为 部 署 生产 服务 器 做 好 准备 


为 生产 服务 器 环境 做 准备 时 要 考虑 以 下 几 点 。 





不 要 在 生产 环境 使 用 Django 开发 服务 器 
Django 更 适合 在 Gunicorn 或 uWSGI 等 中 运行 ， 因为 它们 支持 运行 多 个 职 程 


(worker) , 


不 要 使 用 Django 伺服 静态 文件 
没 必 要 用 Python 进程 处 理 伺服 静态 文件 这 样 的 简单 任务 。 可 以 交 给 Nginx 去 做 ， 
当然 其 他 Web 服务 器 也 能 做 到 ， 比 如 Apache 或 uWSGI。 


检查 settings.py 中 只 针对 开发 环境 的 设置 
Tx 了 DEBUG-True 和 ALLONED_HOSTS， 不 过 可 能 还 有 其 他 设置 要 注意 (让 服务 
器 发 送 电子 邮件 时 还 会 涉及 几 个) 。 


安全 性 

本 书 篇 幅 有 限 ， 无 法 深入 讨论 服务 器 安全 性 。 但 我 要 提醒 你 ， 若 想 自己 运行 服务 
器 ,一定 要 掌握 一 些 安全 知识 。( 有 些 人 选择 使 用 Paas 的 一 个 原因 就 是 无 须 过 多 担 
e: 全 问题 .) 如 果 你 不 知 从 何 着 手 ， 可 以 阅读 这 篇 文章 :“My first 5 minutes on a 
server”。 强烈 建议 你 安装 fail2ban， 然 后 查看 它 的 日 志 志文 件 。 休会 惊奇 地 发 现 ， 尝 试 
暴力 登录 SSH 的 活动 多 得 不 得 了 。 互 联网 可 不 是 什么 安全 之 所 1 
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使 用 Fabric 自 动 部 署 





“自动 化 ， 自 动 化 ， 自 动 化 。” 
一 一 Cay Horstman 
手动 部 署 过 渡 服 务 器 的 意义 通过 自动 部 署 才 能 体现 出 来 。 部 署 的 过 程 能 重复 执行 ， 我 们 才 
能 确信 部 署 到 生产 环境 时 不 会 出 错 。 
使 用 Fabric 可 以 在 服务 器 中 自动 执行 命令 。fabric 3 是 针对 Python 3 的 派生 版 本 : 


$ pip install fabric3 











安装 fabric3 的 过 程 中 ， 只 要 最 后 提示 “Successfully installed...”， 就 可 以 放心 
忽略 “failed building wheel” 错 误 。 





Fabric 的 使 用 方法 一 般 是 创建 一 个 名 为 fabfile.py 的 文件 ， 在 这 个 文件 中 定义 一 个 或 多 个 函 
数 ， 然 后 使 用 命令 行 工具 fab 调用 ， 就 像 这 样 : 
fab function name:host-SERVER ADDRESS 


这 个 命令 会 调用 名 为 function name 的 函数 ， 并 传人 要 连接 的 服务 器 地 址 SERVER. ADDRESS, 
fab 命令 还 有 很 多 其 他 参数 ， 可 以 指定 用 户 名 和 密码 等 ， 详 情 可 执行 fab - -hetp 命令 查阅 。 
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11.1 分 析 一 个 Fabric 部 署 脚 本 

Fabric 的 用 法 最 好 通过 一 个 实例 讲解 。 我 事先 写 好 了 一 个 脚本 '， 自 动 执 行 前 一 章 用 到 的 所 
有 部 署 步骤 。 在 这 个 脚本 中 ， 主 函数 是 deploy， 我 们 在 命令 行 中 要 调用 的 就 是 这 个 函数 。 
deploy 函数 还 会 调用 几 个 辅助 函数 ， 我 们 会 在 过 程 中 逐一 讲解 。 


0 
e 
e 








deploy tools/fabfile.py (ch091001) 


from fabric.contrib.files import append, exists, sed 
from fabric.api import env, local, run 
import random 


REPO URL = 'https://github.com/hjwp/book-example.git' © 


def deploy(): 
site folder = f'/home/[env.user])/sites/([env.host)' 669 
source folder = site folder + '/source' 
create directory structure if necessary(site folder) 
.get latest source(source folder) 
update settings(source folder, env.host) 6 
update virtualenv(source folder) 
update static files(source folder) 
update database(source folder) 


要 把 常量 REPO URL 的 值 改 成 代码 分 享 网 站 中 你 仓库 的 URL, 
env.host 的 值 是 在 命令 行 中 指定 的 服务 器 地 址 ， 例 如 superlists.ottg.eu。 
env.user 的 值 是 登录 服务 器 时 使 用 的 用 户 名 。 


























希望 辅助 函数 的 名 字 能 表明 各 自 的 作用 。 理 论 上 fabfile.py 中 的 每 个 函数 都 能 在 命令 行 中 
调用 ， 所 以 我 使 用 了 一 种 约定 ， 凡 是 以 下 划 线 开头 的 函数 都 不 是 fabfile.py 的 “公开 APT", 
这 些 辅助 国 数 按照 执行 的 顺序 排列 。 


11.1.1 分 析 一 个 Fabric 部 署 脚本 
创建 目录 结构 的 方法 如 下 ， 即 便 某 个 文件 夹 已 经 存在 也 不 会 报错 : 


o 




















deploy tools/fabfile.py (ch091002) 


def create directory structure if necessary(site folder): 
for subfolder in ('database', 'static', 'virtualenv', 'source'): 
run(f'mkdir -p (site folderj/([subfolder)]') 00 


run 是 最 常用 的 Fabric 函数 ， 作 用 是 在 服务 器 中 执行 指定 的 shell 命令 。 本 章 将 用 run 
命令 替代 前 两 章 手 动 执行 的 多 个 命令 。 








注 1: 











BBC 的 儿童 节目 《 蓝 彼得 》 中 经 常 说 这 句 话 ， 因 为 这 是 个 直播 节目 ， 为 了 节省 时 间 ， 往 往 要 事先 做 
好 所 需 的 道具 。 这 句 话 的 原文 是 “Here’s one I made earlier 。 一 一 译 者 注 
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@ mkdir -pæ mkdir 的 一 个 有 用 变种 ， 它 有 两 个 优势 : 其 一 ,深入 多 个 文件 夹层 级 创建 
目录 ; 其 二 ， 只 在 必要 时 创建 目录 。 所 以 ，mkdir -p /tmp/foo/bar 除了 创建 目录 bar 之 
外 ， 如 果 需 要 ， 还 会 创建 父 级 目录 foo。 而 且 ， 如 果 目 录 bar 已 经 存在 ， 也 不 会 报错 。” 


11.1.2 ”使 用 Git 拉 取 源 码 
接 下 来 ， 我 们 想像 前 面 那样 使 用 git pull 把 最 新 的 源码 下 载 到 服务 器 中 : 


deploy tools/fabfile.py (ch091003) 




















def get latest source(source folder): 
if exists(source folder + '/.git'): © 
run(f'cd (source folder) 8& git fetch') 606 
else: 
run(f'git clone (REPO URL) [source folder)') ©@ 
current commit = local("git log -n 1 --format-XH", capture-True) © 
run(f'cd (source folder) && git reset --hard [current commit]') ©@ 


@ exists 检查 服务 器 中 是 否 有 指定 的 文件 夹 或 文件 。 我 们 指定 的 是 隐藏 文件 夹 .git， 检 
查 仓库 是 否 已 经 克隆 到 文件 夹 中 。 

@ 很 多 命令 都 以 cd 开头， 甚 目的 是 设 定 当前 工作 目录 。Fabric 没有 状态 记忆 ， 所 以 下 次 
运行 run 命令 时 不 知道 在 哪个 目录 中 。” 

€ ”在 现 有 仓库 中 执行 git fetch 命令 的 作用 是 从 网 络 中 拉 取 最 新 提交 (与 git pull 类 
似 ， 但 是 不 会 立即 更 新 线 上 源码 )。 

@ 如 有 果 仓 库 不 存在 ， 就 执行 git clone 命令 克隆 一 份 全 新 的 源码 。 

© Fabric 中 的 local 函数 在 本 地 电脑 中 执行 命令 ， 这 个 函数 其 实 是 对 subprocess.Popen 
的 再 包装 ， 不 过 用 起 来 十 分 方便 。 我 们 捕获 git log 命令 的 输出 ， 获 取 本 地 仓库 中 当 
前 提交 的 ID。 这么 做 的 结果 是 ， 服 务 器 中 代码 将 和 本 地 检 出 的 代码 版 本 一 致 〈 前 提 是 
已 经 把 代码 推送 到 服务 器 )。 

@ 执行 git reset --hard 命令 ， 切 换 到 指定 的 提交 。 这 个 命令 会 撤销 在 服务 器 中 对 代码 
仓库 所 做 的 任何 改动 。 

这 个 函数 的 最 终结 果 是 ， 全 新 部 署 时 执行 git clone， 已 有 代码 时 执行 git fetch 和 git 

reset --hard。 手 动 部 署 时 ， 我 们 执行 的 是 等 效 的 git puLL， 但 是 使 用 reset --hard 能 强 

制 覆盖 本 地 改动 。 









































为 了 让 这 个 脚本 可 用 ， 你 要 执行 git push 命令 把 本 地 仓库 推送 到 代码 分 享 网 
站 ， 这 样 服务 器 才能 拉 取 仓库 ， 再 执行 git reset 命令 。 如 果 你 遇 到 Could 
not parse object 错误 ， 可 以 执行 git push 命令 试 试 。 





























注 2: 如 果 你 想 知道 构建 路 径 为 什么 使 用 f 字符 串 而 不 用 前 面 用 过 的 os.path.join， 我 告诉 你 ， 因 为 在 
Windows 中 运行 这 个 脚本 ，path.join 会 使 用 反 斜 线 ， 但 在 服务 器 中 却 要 使 用 斜 线 。 这 是 一 个 常见 陷阱 。 
注 3: Fabric 本 身 也 提供 了 cd 函数 ， 但 我 觉得 本 章 要 多 次 用 到 这 个 函数 ， 太 哆 唆 。 
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11.1.3 更 新 settings.py 
然后 更 新 配置 文件 ， 设 置 ALLOWED_HOSTS 和 DEBUG， 还 要 创建 一 个 密 钥 : 


deploy tools/fabfile.py (ch091004) 


def update settings(source folder, site name): 
settings path = source folder + '/superlists/settings.py' 
sed(settings path, "DEBUG = True", "DEBUG = False") © 
sed(settings path, 
'ALLOWED HOSTS -.4$', 
f'ALLOWED HOSTS = ["[site namej"]' @ 
) 
secret key file = source folder + '/superlists/secret key.py' 
if not exists(secret key file): © 
chars = 'abcdefghijklmnopqrstuvwxyz0123456789!QHSX^&*(- -4)' 


key = ''.join(random.SystemRandom().choice(chars) for _ in range(50)) 


append(secret key file, f'SECRET KEY = "[key]"') 
append(settings path, '\nfrom .secret key import SECRET KEY') O60 





@ Fabric 提供 的 sed 函数 的 作用 是 在 文件 中 替换 字符 串 。 这 里 我 们 把 DEBUG 的 值 由 True 


改 成 FaLse。 
© ”这 里 使 用 sed 调整 ALLONED_H0STS 的 值 ， 使 用 正则 表达 式 匹 配 正确 的 代码 行 。 


© Django 有 几 处 加 密 操 作 要 使 用 SECRET. KEY: cookie 和 CSRF 保护 。 在 服务 器 中 和 源码 
仓库 中 使 用 不 同 的 密 钥 是 个 好 习惯 ， 因 为 仓库 中 的 代码 能 被 所 有 人 看 到 。 如 果 还 没有 
密 钥 ， 这 段 代 码 会 生成 一 个 新 密 钥 ， 然 后 写 入 密 钥 文件 。 有 密 钥 后 ， 每 次 部 署 都 要 使 











用 相同 的 密 钥 。 更 多 信息 参见 Django 文档 。 


© append 的 作用 是 在 文件 未 尾 添加 一 行内 容 。( 这 个 函数 很 聪明 ， 如 果 要 添加 的 行 已 经 
存在 ， 就 不 会 再 次 添加 ; 但 如 果 文 件 未 尾 不 是 一 个 空 行 ， 它 却 不 能 自动 添加 一 个 空 

















行 。 因 此 我 们 加 上 了 \n。) 





@ ”我 使 用 的 是 相对 导入 (relative import， 使 用 from .secret key 而 不 是 from secret key), 
目的 是 确保 从 本 地 而 不 是 从 sys.path 中 其 他 位 置 的 模块 中 导入 。 下 一 章 我 会 更 深入 地 


介绍 相对 导入 。 


(详情 请 参见 第 21 章 )。 你 可 以 根据 个 人 喜好 选择 。 





11.1.4 更 新 虚拟 环境 
接 下 来 创建 或 更 新 虚拟 环境 : 


以 上 是 修改 服务 器 配置 文件 的 一 种 方法 ， 另 一 种 常用 的 方法 是 使 用 环境 变量 


deploy tools/fabfile.py (ch091005) 


def update virtualenv(source folder): 
virtualenv folder = source folder + '/../virtualenv' 
if not exists(virtualenv folder + '/bin/pip'): © 
run(f'python3.6 -m venv ([virtualenv folder]') 


run(f'(virtualenv folderj/bin/pip install -r [source folder)/requirements.txt') 6 
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O 在 virtualenv 文件 夹 中 查找 可 执行 文件 ptp， 以 此 检查 虚拟 环境 是 否 存在 。 
@ ”然后 和 之 前 一 样 ， 执 行 ptp install -r 命令 。 


更 新 静态 文件 只 需要 一 个 命令 : 











deploy tools/fabfile.py (ch091006) 


def update static files(source folder): 
run( 
f'cd (source folder)! © 
' && ../virtualenv/bin/python manage.py collectstatic --noinput' 6 
) 
@ 在 Python 中 ， 可 以 像 这 样 把 一 行 长 字符 串 分 为 多 行 ， 最 终 拼 接 为 一 个 字符 串 。 如 果真 
正 想 要 的 是 字符 串 列表 ,但 是 忘 了 逗号 ， 就 经 常会 出 问题 。 
@ ”如 果 需 要 执行 Django 的 manage.py 命令 ,就 要 指定 虚拟 环境 中 二 进 制 文件 夹 ， 确 保 使 
用 的 是 虚拟 环境 中 的 Django 版 本 ， 而 不 是 系统 中 的 版 本 。 


11.1.5 “需要 时 迁移 数据 库 


最 后 ， 执 行 manage.py migrate 命令 更 新 数据 库 : 














deploy tools/fabfile.py (ch091007) 


def update database(source folder): 
run( 
f'cd (source folder]' 
' && ../virtualenv/bin/python manage.py migrate --noinput' 


) 
指定 --noinput 选项 的 目的 是 不 让 Fabric 难以 处 理 的 交互 式 确 认 (回答 “yes” 或 “no”) 
出 现 。 
到 此 结束 ! 虽然 要 理解 很 多 新 东西 ， 但 这 是 值得 的 ， 因 为 我 们 把 整个 手动 过 程 变 成 自动 过 
程 了 。 而 且 通 过 一 些 逻 辑 处 理 ， 我 们 既 能 部 署 全 新 的 服务 器 ， 也 能 更 新 现 有 的 服务 器 。 如 
果 你 喜欢 源 自 拉丁 语 的 词 ， 可 以 称 这 个 过 程 是 景 等 的 〈idempotent ) ， 即 不 管 执 行 一 次 还 是 
执行 多 次 ， 效 果 是 一 样 的 。 


11.2. 试用 部 署 脚本 


下 面 在 现 有 的 过 渡 网 站 中 试 一 下 这 个 脚本 ， 看 它 是 如 何 更 新 现 有 网 站 的 : 


$ cd deploy_tools 
$ fab deploy:host=elspeth@superlists-staging.ottg.eu 

































































[superlists-staging.ottg.eu] Executing task 'deploy' 

[superlists-staging.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists-stagin 
[superlists-staging.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists-stagin 
[superlists-staging.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists-stagin 








ikE4: REE XX idempotent, f ] ise idem。 一 一 译 者 注 





[superlists-staging.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists-stagin 
[superlists-staging.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists-stagin 
[superlists-staging.ottg.eu] run: cd /home/elspeth/sites/superlists-staging.ottg 
[localhost] local: git log -n 1 --format-XH 

[superlists-staging.ottg.eu] run: cd /home/elspeth/sites/superlists-staging.ottg 
[superlists-staging.ottg.eu] out: HEAD is now at 85a6c87 Add a fabfile for autom 
[superlists-staging.ottg.eu] out: 


[superlists-staging.ottg.eu] run: sed -i.bak -r -e 's/DEBUG = True/DEBUG = False 
[superlists-staging.ottg.eu] run: echo 'ALLOWED HOSTS - ["superlists-staging.ott 
[superlists-staging.ottg.eu] run: echo 'SECRET KEY = 'W''4p2u8fi6)bltep(6nd 3tt 
[superlists-staging.ottg.eu] run: echo 'from .secret key import SECRET KEY' >> " 


[superlists-staging.ottg.eu] run: /home/elspeth/sites/superlists-staging.ottg.eu 
[superlists-staging.ottg.eu] out: Requirement already satisfied (use --upgrade t 
[superlists-staging.ottg.eu] out: Requirement already satisfied (use --upgrade t 
[superlists-staging.ottg.eu] out: Cleaning up... 

[superlists-staging.ottg.eu] out: 


[superlists-staging.ottg.eu] run: cd /home/elspeth/sites/superlists-staging.ottg 
[superlists-staging.ottg.eu] out: 

[superlists-staging.ottg.eu] out: 0 static files copied, 11 unmodified. 
[superlists-staging.ottg.eu] out: 


[superlists-staging.ottg.eu] run: cd /home/elspeth/sites/superlists-staging.ottg 
[superlists-staging.ottg.eu] out: Creating tables ... 
[superlists-staging.ottg.eu] out: Installing custom SQL ... 
[superlists-staging.ottg.eu] out: Installing indexes ... 
[superlists-staging.ottg.eu] out: Installed 0 object(s) from 0 fixture(s) 
[superlists-staging.ottg.eu] out: 

Done. 

Disconnecting from superlists-staging.ottg.eu... done. 


太 棒 了 。 我 喜欢 让 电脑 成 页 地 显示 这 种 输出 (事实 上 ， 我 完全 无 法 阻止 自己 制造 20 世纪 
70 年 代 的 电脑 发 出 的 “ 距 呢 - WNE - 踊 呢 ”声音 ， 就 像 《 异 形 》 中 的 电脑 Mother 一 样 “)。 
如 有 果 仔 细 看 这 些 输出 ， 会 发 现 脚本 在 执行 我 们 的 命令 : 虽然 目录 结构 已 经 建 好 ， 但 mkdir -p 
命令 还 是 能 顺利 执行 ， 然 后 执行 git puLL 命令 ， 拉 取 我 们 刚刚 提交 的 几 次 改动 ，sed 和 
echo >> 修改 settings.py 文件 ， 然 后 顺利 执行 完 pip install -r requirements.txt 命令 ， 
注意 ， 现 有 的 虚拟 环境 中 已 经 安装 了 全 部 所 需 的 包 ;， collectstatic 命令 发 现 静态 文件 也 
收集 好 了 ， 最 后 ， 执 行 migrate 命令 。 这 个 过 程 完全 没 障 人 得。 





















































配置 Fabric 
如 果 使 用 SSH 密 钥 登录 ， 密 钥 存 储 在 默认 的 位 置 ， 而 且 本 地 电脑 和 服务 器 使 用 相同 的 
用 户 名 ， 那 么 无 须 配 置 即 可 直接 使 用 Fabric。 如 果 不 满 足 这 几 个 条 件 ， 就 要 配置 用 户 
Z. SSH 密 钥 的 位 置 或 密码 等 ， 才 能 让 fab 执行 命令 。 
这 几 个 信息 可 在 命令 行 中 传 给 Fabric。 更 多 信息 可 执行 $ fab --help 命令 查看 ， 或 者 
阅读 Fabric 的 文档 。 



































注 5: Mother 是 电影 《异形 》 系 列 中 诺 史 莫 号 的 中 央 控 制 系 统 。 一 一 译 者 注 
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2.1 部署 到 线 上 服务 器 


























下 面 在 线 上 服务 器 中 试 试 这 个 脚本 : 
$ fab deploy:host=elspeth@superlists.ottg.eu 
$ fab deploy --host=superlists.ottg.eu 
[superlists.ottg.eu] Executing task 'deploy' 
[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu 
[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu/databa 
[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu/static 
[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu/virtua 
[superlists.ottg.eu] run: mkdir -p /home/elspeth/sites/superlists.ottg.eu/source 
[superlists.ottg.eu] run: git clone https://github.com/hjwp/book-example.git /ho 
[superlists.ottg.eu] out: Cloning into '/home/elspeth/sites/superlists.ottg.eu/s 
[superlists.ottg.eu] out: remote: Counting objects: 3128, done. 
[superlists.ottg.eu] out: Receiving objects: 0% (1/3128) 
Essa] 
[superlists.ottg.eu] out: Receiving objects: 100% (3128/3128), 2.60 MiB | 829 Ki 
[superlists.ottg.eu] out: Resolving deltas: 100% (1545/1545), done. 
[superlists.ottg.eu] out: 
[localhost] local: git log -n 1 --format=%H 
[superlists.ottg.eu] run: cd /home/elspeth/sites/superlists.ottg.eu/source && gi 
[superlists.ottg.eu] out: HEAD is now at 6c8615b use a secret key file 
[superlists.ottg.eu] out: 
[superlists.ottg.eu] run: sed -i.bak -r -e 's/DEBUG = True/DEBUG = False/g' "S(e 
[superlists.ottg.eu] run: echo 'ALLOWED HOSTS = ["superlists.ottg.eu"]' >> "$(ec 
[superlists.ottg.eu] run: echo 'SECRET KEY = 'W''mqu(ffwid5vleolXke^jil*ximkj-4 
[superlists.ottg.eu] run: echo 'from .secret key import SECRET KEY' »» "S(echo / 
[superlists.ottg.eu] run: python3.6 -m venv /home/elspeth/sites/superl 
[superlists.ottg.eu] out: Using interpreter /usr/bin/python3.6 
[superlists.ottg.eu] out: Using base prefix '/usr' 
[superlists.ottg.eu] out: New python executable in /home/elspeth/sites/superlist 
[superlists.ottg.eu] out: Also creating executable in /home/elspeth/sites/superl 
[superlists.ottg.eu] out: Installing SetuptootLs...........................，. done. 
[superlists.ottg.eu] out: Installing Pip............ leer nnn done. 
[superlists.ottg.eu] out: 
[superlists.ottg.eu] run: /home/elspeth/sites/superlists.ottg.eu/source/../virtu 
[superlists.ottg.eu] out: Downloading/unpacking Django--1.11 (from -r /home/el 
[superlists.ottg.eu] out: Downloading Django-1.11.tar.gz (8.0MB): 
[...] 
[superlists.ottg.eu] out: Downloading Django-1.11.tar.gz (8.0MB): 100% 8.0M 
[superlists.ottg.eu] out: ^ Running setup.py egg info for package Django 
[superlists.ottg.eu] out: 
[superlists.ottg.eu] out: warning: no previously-included files matching ' 
[superlists.ottg.eu] out: warning: no previously-included files matching '*. 
[superlists.ottg.eu] out: Downloading/unpacking gunicorn--17.5 (from -r /home/el 
[superlists.ottg.eu] out: | Downloading gunicorn-17.5.tar.gz (367kB): 100% 367k 
[...] 
[superlists.ottg.eu] out: Downloading gunicorn-17.5.tar.gz (367kB): 367kB down 
[superlists.ottg.eu] out: ^ Running setup.py egg info for package gunicorn 
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[superlists.ottg.eu] out: 
[superlists.ottg.eu] out: Installing collected packages: Django, gunicorn 
[superlists.ottg.eu] out: ^ Running setup.py install for Django 


[superlists.ottg.eu] out: changing mode of build/scripts-3.3/django-admin.py 
[superlists.ottg.eu] out: 

[superlists.ottg.eu] out: warning: no previously-included files matching ' 
[superlists.ottg.eu] out: warning: no previously-included files matching '*. 
[superlists.ottg.eu] out: changing mode of /home/elspeth/sites/superlists.ot 
[superlists.ottg.eu] out: ^ Running setup.py install for gunicorn 
[superlists.ottg.eu] out: 

[superlists.ottg.eu] out: Installing gunicorn paster script to /home/elspeth 
[superlists.ottg.eu] out: Installing gunicorn script to /home/elspeth/sites/ 
[superlists.ottg.eu] out: Installing gunicorn django script to /home/elspeth 


[superlists.ottg.eu] out: Successfully installed Django gunicorn 
[superlists.ottg.eu] out: Cleaning up... 
[superlists.ottg.eu] out: 


[superlists.ottg.eu] run: cd /home/elspeth/sites/superlists.ottg.eu/source && .. 
[superlists.ottg.eu] out: Copying '/home/elspeth/sites/superlists.ottg.eu/source 
[superlists.ottg.eu] out: Copying '/home/elspeth/sites/superlists.ottg.eu/source 
[...] 

[superlists.ottg.eu] out: Copying '/home/elspeth/sites/superlists.ottg.eu/source 
[superlists.ottg.eu] out: 

[superlists.ottg.eu] out: 11 static files copied. 

[superlists.ottg.eu] out: 

[superlists.ottg.eu] run: cd /home/elspeth/sites/superlists.ottg.eu/source && .. 
[superlists.ottg.eu] out: Creating tables ... 

[superlists.ottg.eu] out: Creating table auth permission 

[25.4] 

[superlists.ottg.eu] out: Creating table lists item 

[superlists.ottg.eu] out: Installing custom SQL ... 

[superlists.ottg.eu] out: Installing indexes ... 

[superlists.ottg.eu] out: Installed 0 object(s) from 0 fixture(s) 
[superlists.ottg.eu] out: 

Done. 

Disconnecting from superlists.ottg.eu... done. 


DENE — MEWE — eU. "TELE, SARATA AAE. xXx. Afr git clone 
命令 克隆 一 个 全 新 的 仓库 ， 而 没有 执行 git pull, 而 且 从 零 开始 创建 了 一 个 新 的 虚拟 环 
境 ， 还 安装 了 pip 和 Django; collectstatic 命令 这 次 真 的 创建 了 很 多 新 文件 ，migrate 看 
起 来 也 完成 了 任务 。 


11.2.2 ”使 用 sed 配 置 Nginx 和 Gunicorn 


把 网 站 放 到 生产 环境 之 前 还 要 做 什么 呢 ? 根据 配置 笔记 ， 还 要 使 用 模板 文件 创建 Nginx 虚 
拟 主机 和 Systemd 服务 。 使 用 Unix 命令 行 工 具 完 成 这 一 操作 怎么 样 ? 
elspeth@server:$ sed "s/SITENAME/superlists.ottg.eu/g" V 


source/deploy tools/nginx.template.conf V 
| sudo tee /etc/nginx/sites-available/superlists.ottg.eu 


sed (stream editor， 流 编辑 器 ) 的 作用 是 编辑 文本 流 。Fabric 中 进行 文本 替换 的 了 国 数 也 叫 
sed， 这 并 不 是 巧合 。 这 里 ， 使 用 s/replaceme/withthis/g 名 法 把 字符 串 SITENAME 替换 成 
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网 站 的 地 址 。" 然后 使 用 管道 操作 (|) 把 文本 流传 给 一 个 有 root 权限 的 用 户 处 理 (sudo), 
把 传 入 的 文本 流 写 入 一 个 文件 ， 即 sites-available 文件 夹 中 的 一 个 虚拟 主机 配置 文件 。 
然后 使 用 一 个 符号 链 激 活 这 个 文件 配置 的 虚拟 主机 : 


elspeth@server:$ sudo ln -s ../sites-available/superlists.ottg.eu Y 
/etc/nginx/sites-enabled/superlists.ottg.eu 


再 使 用 sed 编写 Systemd 服务 : 


elspeth@server: sed "s/SITENAME/superlists.ottg.eu/g" V 
source/deploy tools/gunicorn-systemd.template.service V 
| sudo tee /etc/systemd/system/gunicorn-superlists.ottg.eu.service 


最 后 ， 启 动 这 两 个 服务 : 


elspeth@server:$ sudo systemctl daemon-reload 
elspethüserver:$ sudo systemctl reload nginx 
elspethüserver:$ sudo systemctl enable gunicorn-superlists.ottg.eu 
elspethüserver:$ sudo systemctl start gunicorn-superlists.ottg.eu 


现在 访问 网 站 ， 见 图 11-1。 运 行 起 来 了 ， 太 棒 了 | 




















To-Do lists - Mozilla Firefox x 





File Edit View History Bookmarks Tools Help 
To-Do lists x c 
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Your To-Do list 


Enter a to-do item 


1: Example todo item 1 
2: Example todo item 2 
3: These todo items are boring 


4: They're good todo items brant. 











11-1: BRI — GRIE — GRIC XU XS CT EEOK T 

















ike: 你 可 能 在 网 上 见 过 电脑 达 人 使 用 奇怪 的 s/ change-this/to-this 的 写法 ， 这 下 你 知道 它 的 作用 了 吧 。 
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做 得 不 错 。 可 靠 的 fabfile， 赏 你 一 块 饼干 。 现 在 可 以 把 它 添加 到 仓库 中 了 : 


$ git add deploy_tools/fabfile.py 
$ git commit -m "Add a fabfile for automated deploys" 


"El 人 二 二 $1 > J-L 

11.3 ”使 用 Git 标 签 标 注 发 布 状态 
最 后 还 要 做 些 管理 操作 。 为 了 保留 历史 标记 ， 使 用 Git 标签 (tag) 标注 代码 库 的 状态 ， 指 
明 服 务 器 中 当前 使 用 的 是 哪个 版 本 : 

$ git tag LIVE 

$ export TAG-S(date «DEPLOYED-XF/*HXM) # AE, — IT IR] X 

$ echo $TAG # Zi; "DEPLOYED-" lb] ik] x 

$ git tag $TAG 

$ git push origin LIVE $TAG # 推送 标签 
现在 ， 无 论 何 时 都 能 轻松 查看 当前 代码 库 和 服务 器 中 的 版 本 有 何 差异 。 这 个 操作 在 后 面 介 
绍 数据 库 迁 移 的 章节 中 也 会 用 到 。 看 一 下 提交 历史 中 的 标签 


$ git log --graph --oneline --decorate 
Fess] 


总 之 ， 现 在 我 们 部 署 了 一 个 线 上 网 站 。 告 诉 你 的 朋友 吧 ! 如 果 他 们 不 感 兴趣 ， 就 告诉 自己 
的 妈妈 ! 下 一 章 我 们 要 继续 编程 。 


11.4 延伸 阅读 


部 署 没有 唯一 正确 的 方法 ， 而 且 我 无 论 如 何 也 算 不 上 资深 专家 。 我 试 着 把 你 领 进门 ， 但 有 
很 多 事情 可 以 使 用 不 同 的 方法 处 理 ， 还 有 很 多 很 多 的 知识 要 学 习 。 下 面 我 列 出 了 一 些 阅 读 
HER ESZ, 

e Hynek Schlawack 的 文章 “Solid Python Deployments for Everybody" , 

* Dan Bravender 的 文章 “Git-based fabric deploys are awesome" , 

。 Dan Greenfield 和 Audrey Roy 合 著 的 Two Scoops of Django 中 与 部 署 相 关 的 章节 。 

e Heroku 团队 写 的 “The 12-factor App", 


如 果 想 知道 如 何 自动 完成 配置 过 程 ， 以 及 如 何 使 用 Fabric 的 替代 品 Ansible， 请 阅读 附 
3k C, 
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自动 部 署 
Fabric 
Fabric 允许 在 Python 脚本 中 编写 可 在 服务 器 中 执行 的 命令 。 这 个 工具 很 适合 自动 执 
行 服务 器 管理 任务 。 
A 
如 果 部 署 脚本 要 在 已 经 配置 的 服务 器 中 运行 ， 就 要 把 它 设计 成 既 可 在 全 新 的 服务 器 
中 运行 ， 又 能 在 已 经 配置 的 服务 器 中 运行 。 
把 配置 文件 纳入 版 本 控制 
一 定 不 能 只 在 服务 器 中 保存 一 份 配置 文件 副本 。 配 置 文件 对 应 用 非常 重要 ， 应 该 和 
其 他 文件 一 样 纳入 版 本 榨 制 。 
自动 配置 
最 终 ， 所 有 操作 都 要 实现 自动 化 ， 包 括 配 置 全 新 的 服务 器 和 安装 所 需 的 全 部 正确 软 
件 。 配 置 的 过 程 中 会 和 主机 供应 商 的 API 交互 。 
配置 管理 工具 
Fabric 很 灵活 ， 但 其 还 辑 还 是 基于 脚本 的 。 高 级 工具 使 用 声明 式 的 方法 ， 用 起 来 更 
方便 。Ansible 和 Vagrant 都 值得 一 试 (参见 附录 C) ， 此 外 还 有 很 多 同类 工具 ， 例 
如 Chef, Puppet, Salt 和 Juju 等 。 
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第 12 章 


输入 验证 和 测试 的 组 织 方式 





接 下 来 要 实现 的 功能 是 输入 验证 。 测 试 越 写 越 多 ， 慢 慢 地 你 会 发 现 ， 把 所 有 测试 都 写 在 
functional tests.py 和 tests.py 中 有 诸多 不 便 ， 因 此 我 们 将 重新 组 织 测 试 ， 将 它们 写 入 多 个 文 
件 一 一 这 算得 上 是 对 测试 本 身 的 重 构 。 


此 外 ， 我 们 还 将 定义 一 个 通用 的 显 式 等 待 辅助 方法 。 


12.1 “针对 验证 的 功能 测试 : 避免 提交 空 待 办 事项 


我 们 的 网 站 开始 有 用 户 了 。 我 们 注意 到 用 户 有 时 会 犯错 ， 把 他 们 的 清单 弄 得 一 团 糟 ， 例 如 
不 小 心 提 交 空 的 待 办 事项 ， 或 者 在 一 个 清单 中 输入 两 个 相同 的 待 办 事项 。 计 算 机 能 帮助 我 
们 避免 犯 这 种 思春 的 错误 ， 看 一 下 能 否 让 网 站 提供 这 种 帮助 。 


下 面 是 一 个 功能 测试 的 大 纲 : 









































functional tests/tests.py (ch111001) 
def test cannot add empty list items(self): 
# 伊 迪 丝 访问 首页 ， 不 小 心 提交 了 一 个 空 待 办 事项 
# 输入 框 中 没 输 入 内 容 ， 她 就 按 下 了 回 车 键 


# 首页 刷新 了 ， 显 示 一 个 错误 消息 
# 提示 待 办 事项 不 能 为 空 














# 她 输入 一 些 文字 ， 然 后 再 次 提交 ， 这 次 没 问 题 了 





# 她 有 点 儿 调 皮 ， 又 提交 了 一 个 空 待 办 事项 











# 在 清单 页 面 她 看 到 了 一 个 类 似 的 错误 消息 
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# 输入 文字 之 后 就 没 问 题 了 

self.fail('write me!') 
测试 写 得 很 好 ， 但 功能 测试 文件 变 得 有 点 儿 腔 肿 ， 在 继续 之 前 ， 要 把 功能 测试 分 成 多 个 文 
件 ， 每 个 文件 中 只 放 一 个 测试 方法 。 
还 记得 吗 ? 功能 测试 和 “用 户 故事 ”联系 紧密 。 如 果 使 用 问题 跟踪 程序 等 项 目 管理 工具 ， 
你 可 能 想 让 每 个 文件 对 应 一 个 问题 或 工 单 (ticket)， 而 且 文 件 名 中 要 包含 工 单 的 编号 。 如 
果 你 喜欢 使 用 “功能 ”的 概念 考虑 问题 〈 一 个 功能 可 能 包含 多 个 用 户 故 事 )， 可 以 用 一 个 
文件 对 应 一 个 功能 ， 一 个 文件 中 只 写 一 个 测试 类 ， 每 个 用 户 故 事 使 用 多 个 测试 方法 实现 。 


还 要 编写 一 个 测试 基 类 ， 让 所 有 测试 类 都 继承 这 个 基 类 。 下 面 分 步 介 绍 分 拆 过 程 。 


12.1.1. BEEN 


重 构 时 最 好 能 让 整个 测试 组 件 都 通过 。 刚 才 我 们 故意 编写 了 一 个 失败 测试 ， 现 在 要 使 用 
unittest 提供 的 修饰 器 @skip 临时 禁止 执行 这 个 测试 方法 : 






































functional tests/tests.py (ch111001-1) 


from unittest import skip 


[...] 


@skip 
def test cannot add empty list items(self): 


这 个 修饰 器 告诉 测试 运行 程序 ， 忽 上 略 这 个 测试 。 再 次 运行 功能 测试 就 会 看 到 这 么 做 起 作用 
了 ， 因 为 测试 组 件 仍 能 通过 : 


$ python manage.py test functional tests 

















Ran 4 tests in 11.577s 
OK 


跳 过 测试 很 危险 ， 把 改动 提交 到 仓库 之 前 记得 删 掉 eskip 修饰 器 。 这 就 是 逐 
行 审 查 差异 的 目的 。 














别 忘 了 “ 遇 红 / 变 绿 / 重 构 ” 中 的 “ 重 构 ” 


TDD 有 时 会 被 批评 说 得 到 的 代码 架构 不 好 ， 因 为 开发 者 关注 的 是 怎么 让 测试 通过 ， 没 
有 停 下 来 思考 整个 系统 应 该 怎么 设计 。 我 觉得 这 么 说 有 点 不 公平 。 


TDD 不 是 万 能 良药 。 你 仍 要 花 时 间 考 虑 好 的 设计 。 不 过 开发 者 经 常会 忘记 “ 遇 红 / cd 
绿 / 重 构 ” 中 还 有 “ 重 构 ”这 一 步 。 使 用 TDD， 为 了 让 测试 通过 ， 可 以 随意 丢掉 旧 代 
码 ， 但 它 也 要 求 你 在 测试 通过 之 后 花 点 儿 时 间 重 构 ， 改 进 设计 。 否 则 “技术 债务 ”将 


高 高 筑 起 。 
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这 要 视 情 况 而 定 。 





不 过 ， 重 构 的 最 佳 方法 往往 不 那么 容易 想到 ， 可 能 等 到 写 下 代码 之 后 的 几 天 、 几 周 其 
至 几 个 月 ， 处 理 完全 无 关 的 事情 时 ， 突 然 灵光 一 闪 才 能 想 出 来 。 在 解决 其 他 问题 的 途 





中 ， 应 该 停 下 来 去 重 构 以 前 的 代码 吗 ? 


比如 像 本 章 开始 这 种 情况 ， 我 们 还 没有 开始 编写 新 代码 ， 知 首 
都 能 正常 运行 ， 所 以 可 以 跳 过 刚 编 写 的 功能 测试 (让 测试 全 部 通过 ) ， 先 重 构 。 


在 本 章 后 面 的 内 容 中 还 会 遇 到 需要 重 构 的 代码 。 届 时 ， 我 们 不 能 冒险 在 无 法 正常 
的 应 用 中 重 构 ， 可 以 在 便签 上 做 个 记录 ， 等 测试 组 件 能 全 部 通过 之 后 再 重 村 





道 一 切 


运行 





12.1.2 ”把 功能 测试 分 拆 到 多 个 文件 中 
先 把 各 个 测试 方法 放 在 单独 的 类 中 ， 但 仍然 保存 在 同一 个 文件 里 : 


functional tests/tests.py (ch111002) 


class FunctionalTest(StaticLiveServerTestCase): 
def setUp(self): 
[2s] 
def tearDown(self): 


def wait for row in list table(self, row text): 


class NewVisitorTest(FunctionalTest): 
def test can start a list for one user(self): 


[...] 


def test multiple users can start lists at different urls(self): 


class LayoutAndStylingTest(FunctionalTest): 


def test layout and styling(self): 
ves] 


class ItemValidationTest(FunctionalTest): 


(skip 
def test cannot add empty list items(self): 


然后 运行 功能 测试 ， 看 是 否 仍 能 通过 


Ran 4 tests in 11.577s 


OK 
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这 么 做 可 能 有 点 劳动 量 ， 或 许 能 找到 一 种 步骤 更 少 的 方法 。 但 是 ， 正 如 我 一 直 所 说 的 ， 针 
对 简单 的 情况 练习 步步为营 的 方法 ， 以 后 遇 到 复杂 的 情况 就 能 游 丸 有 余 。 

现在 分 拆 这 个 测试 文件 ， 一 个 类 写 入 一 个 文件 ， 而 且 还 有 一 个 文件 用 来 保存 所 有 测试 类 都 
继承 的 基 类 。 要 复制 四 份 test.py， 重 命名 各 个 文件 ， 然 后 删除 各 文件 中 不 需要 的 代码 : 





$ git mv functional tests/tests.py functional tests/base.py 

$ cp functional tests/base.py functional tests/test simple list creation.py 
$ cp functional tests/base.py functional tests/test layout and, styling.py 

$ cp functional tests/base.py functional tests/test list item validation.py 


base.py 只 需 保 留 FunctionalTest 类 ， 其 他 代码 全 部 删 掉 。 留 下 基 类 中 的 辅助 方法 ， 因 为 
觉得 在 新 的 功能 测试 中 会 用 到 : 


我 们 编写 的 第 一 个 功能 测试 现在 放 在 单独 的 文 伯 








functional tests/base.py (ch111003) 


from django.contrib.staticfiles.testing import StaticLiveServerTestCase 
from selenium import webdriver 

from selenium.common.exceptions import WebDriverException 

import time 


MAX WAIT - 10 


class FunctionalTest(StaticLliveServerTestCase): 


def setUp(self): 
[Lz] 
def tearDown(self): 
[...] 
def wait for row in list table(self, row text): 


[...] 


把 辅助 方法 放 在 FunctionalTest 基 类 中 是 避免 功能 测试 代码 重复 的 方法 之 
一 。 第 25 章 会 用 到 “页 面 模式 ”(page pattern) ， 与 这 种 方法 有 关 ， 但 不 用 
继承 ， 用 组 合 模式 。 





tr 





中 了 ， 而 且 这 个 文件 中 只 有 一 个 类 和 一 个 


测试 方法 : 


functional tests/test simple list creation.py (ch111004) 





from .base import FunctionalTest 
from selenium import webdriver 
from selenium.webdriver.common.keys import Keys 


class NewVisitorTest(FunctionalTest): 


def test can start a list for one user(self): 





def test multiple users can start lists at different urls(self): 


[55] 


我 用 到 了 相对 导入 (from .base)， 有 些 人 喜欢 在 Django 应 用 中 大 量 使 用 这 种 导入 方式 
(例如 ， 视 图 可 能 会 使 用 from .models import List 导入 模型 ， 而 不 用 from list.models), 
这 其 实 是 个 人 喜好 问题 ， 只 有 十 分 确定 要 导入 的 文件 位 置 不 会 变化 时 ， 我 才 会 选择 使 用 相 
对 导入 。 这 里 使 用 相对 导入 是 因为 ， 我 确定 所 有 测试 文件 都 会 和 它们 要 继承 的 base.py 放 
在 一 起 。 


针对 布局 和 样式 的 功能 测试 现在 也 放 在 独立 的 文件 和 类 中 : 












































functional tests/test layout and styling.py (ch111005) 





from selenium.webdriver.common.keys import Keys 
from .base import FunctionalTest 


class LayoutAndStylingTest(FunctionalTest): 
[4] 


刚 编写 的 验证 测试 也 放 在 单独 的 文件 中 了 : 











functional tests/test list item validation.py (ch111006) 





from selenium.webdriver.common.keys import Keys 
from unittest import skip 
from .base import FunctionalTest 


class ItemValidationTest(FunctionalTest): 


(skip 
def test cannot add empty list items(self): 
bes] 
可 以 再 次 执行 manage.py test functional tests 命令 ， 确 保 一 切 都 正常 ， 还 要 确认 所 有 三 
个 测试 都 运行 了 : 


Ran 4 tests in 11.577s 

















OK 
现在 可 以 删 掉 @skip 修饰 器 了 : 


functional tests/test list item validation.py (ch111007) 





class ItemValidationTest(FunctionalTest): 


def test cannot add empty list items(self): 








[...] 
12.1.3 运行 单个 测试 文件 
拆 分 之 后 有 个 附带 的 好 处 可 以 运行 单个 测试 文件 ， 如 下 所 示 : 
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$ python manage.py test functional tests.test list item validation 


[aa 

AssertionError: write me! 
太 好 了 ， 如 果 只 关心 其 中 一 个 测试 ， 现 在 无 须 坐 等 所 有 功能 测试 都 运行 完 就 能 看 到 结果 
了 。 不 过 ， 记 得 要 不 时 运行 所 有 功能 测试 ， 检 查 是 否 有 回归 。 本 书后 面 的 内 容 会 介绍 如 何 
把 这 项 任务 交 给 自动 化 持续 集成 循环 完成 。 现 在 ， 先 提交 ; 


$ git status 
$ git add functional tests 
$ git commit -m "Moved Fts into their own individual files" 


很 好 ， Si HER 6 测试 拆 分 到 不 同 的 文件 中 了 。 接 下 来 ， 我 们 将 着 手 编写 功能 测试 。 但 在 
此 之 前 ， 你 可 能 猜 到 了 ， 我 们 还 需 拆 分 单元 测试 文件 。 


12.2 功能 测试 新 工具 : 通用 显 式 等 待 辅助 方法 


现在 开始 实现 本 章 开头 编写 的 测试 ， 至 少 先 把 前 面 的 部 分 写 好 : 



































functional tests/test list item validation.py (ch111008) 





def test cannot add empty list items(self): 
# 伊 迪 丝 访问 首页 ， 不 小 心 提 交 了 一 个 空 待 办 事项 
# 输入 框 中 没 输 入 内 容 ， 她 就 按 下 了 回 车 键 
self.browser.get(self.live server url) 
self.browser.find element by id('id new item').send keys(Keys.ENTER) 



























































# 首页 刷新 了 ， 显 示 一 个 错误 消息 

# 提示 竺 办 事项 不 能 为 空 

self.assertEqual( 
self.browser.find element by css selector('.has-error').text, © 
"You can't have an empty list item" @ 




















) 








# 她 输入 一 些 文字 ， 然 后 再 次 提交 ， 这 次 没 问 题 了 
self.fail('finish this test!') 











0 ”通过 CSS 类 .has-error 查找 错误 文本 。Bootstrap 为 错误 文本 提供 了 很 多 有 用 的 样式 。 
@ ”确认 错误 文本 中 有 我 们 想 显示 的 消息 


过 ， 你 能 看 出 这 个 测试 有 什么 潜在 问题 吗 ? 


好 吧 ， 本 节 的 标题 已 经 给 出 提示 : 如 果 页 面 刷 新 ， 就 要 显 式 等 待 ， 否 则 ，Selenium 可 能 会 
在 页 面 加 载 之 前 查找 .has-error 元 素 。 















































We 








首次 需要 显 式 等 待 时 ， 我 们 定义 了 一 个 辅助 方法 。 但 对 这 个 测试 来 说 ， 你 可 能 觉得 用 辅助 
方法 有 点 小 题 大 做 。 不 过 ， 在 测试 中 能 使 用 通用 的 方式 表达 “等 到 断言 通过 ”也 不 错 ， 比 
如 这 样 : 





functional tests/test list item validation.py (ch111009) 








] 

# 首页 刷新 了 ， 显 示 了 一 条 错误 消息 

# 提示 待 办 事项 不 能 为 空 

self.wait for(lambda: self.assertEqual( ©@ 
self.browser.find element by css selector('.has-error').text, 
"You can't have an empty list item" 

















)) 


@ 不 再 直接 调用 断言 ， 而 是 把 断言 包装 到 一 个 lambda 函数 中 ， 然 后 再 把 它 传 给 一 个 打算 
命名 为 watt for 的 辅助 方法 。 




















如 果 你 从 未 在 Python 中 见 过 lambda 函数 ， 请 阅读 后 文 “Lambda 函数 ”。 








那 应 该 如 何 实现 这 个 wait_for 方法 呢 ? 打开 basepy， 复 制 现 有 的 watt for row in list table 
方法 ， 稍 微 修 改 一 下 : 





functional tests/base.py (ch111010) 


def wait for(self, fn): © 
start time - time.time() 
while True: 
try: 
table = self.browser.find element by id('id list table') 6 
rows - table.find elements by tag name('tr') 
self.assertIn(row text, [row.text for row in rows]) 
return 
except (AssertionError, WebDriverException) as e: 
if time.time() - start time » MAX WAIT: 
raise e 
time.sleep(0.5) 


o 复制 现 有 的 方法 ， 但 将 其 重 命名 为 waitfor 并 修改 参数 ， 期 待 传人 一 个 国 数 。 
e 现在 的 代码 仍然 检查 表格 中 的 行 。 怎 样 修 改 才能 支持 传人 的 fn 函数 呢 ? 
像 这 样 : 





functional tests/base.py (ch111011) 


def wait for(self, fn): 
start time - time.time() 
while True: 
try: 
return fn() © 





输入 验证 和 测试 的 组 织 方式 | 165 


except (AssertionError, WebDriverException) as e: 
if time.time() - start time » MAX WAIT: 
raise e 
time.sleep(0.5) 


try/except 的 主体 不 再 检查 表格 中 的 行 ， 而 是 调用 传 入 的 国 数 。 如 果 没 有 异常 抛 出 ， 
就 返回 传 入 的 那个 函数 的 返回 值 ， 立 即 跳 出 循环 。 





























lambda 函数 


在 Python 中 ,一 次 性 单行 函数 使 用 lambda 构建 ， 这 样 免 去 了 使 用 def..(): 和 缩 进 代 
码 块 的 麻烦 。 


>>> myfn = lambda x: x+1 
>>> myfn(2) 
3 


>>> myfn(5) 
6 
>>> adder = lambda x, y: x * y 


>>> adder(3, 2) 
5 


A Tikc4pby. &J]45—PB KS Ppd 8 RU USA. NEAR 
lambda $ žk, BIFE RÍ, m BSTYUL ERAT: 


»»» def addthree(x): 
return x * 3 


Es addthree(2) 

5 

>>> myfn = lambda: addthree(2) # 注意 ， 这 里 的 addthree 不 会 立即 调用 
>>> myfn 

«function «lambda» at 0x7f3b140339d8> 

>>> myfn() 

5 


»»» myfn() 
5 














下 来 看 watt for 辅助 方法 的 实际 效果 : 








$ python manage.py test functional tests.test list item validation 


E 


ERROR: test cannot add empty list items 
(functional tests.test list item validation.ItemValidationTest) 
Traceback (most recent call last): 
File "/.../superlists/functional tests/test list item validation.py", line 
15, in test cannot add empty list items 
self.wait for(lambda: self.assertEqual( Q9 
File "/.../superlists/functional tests/base.py", line 37, in wait for 
raise e @ 
File "/.../superlists/functional_tests/base.py", line 34, in wait_for 
return fn() @ 
File "/.../superlists/functional_tests/test_list_item_validation.py", line 








16, in «lambda» 
self.browser.find element by css selector('.has-error').text, © 

Less] 

selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 

element: .has-error 


Ran 1 test in 10.57550 
FAILED (errors=1) 
调用 跟踪 的 顺序 有 点 儿 乱 ， 不 过 我 们 或 多 或 少 能 猜 到 到 底 发 生 了 什么 。 
@ 功能 测试 的 第 15 行进 入 self.wait for 辅助 方法 ， 传 人 assertEqual 的 lambda 版 本 。 


O ”进入 base.py 中 的 self.wait_for， 可 以 看 到 我 们 调用 了 那个 Lambda 函数 ， 但 是 由 于 超 
时 而 抛 出 raise e, 

e 为 了 查 明 异常 来 自 何 处 ， 调 用 跟踪 又 把 我 们 带 到 test_list_item_validation.py 文件 中 的 
lambda 函数 主体 里 ， 并 且 告 诉 我 们 ， 是 在 尝试 查找 .has-error 元 素 时 失败 的 。 

现在 我 们 进入 了 函数 式 编程 领域 ， 即 把 一 个 函数 作为 参数 传 给 另 一 个 函数 一 一 这 可 能 有 点 

烧 脑 ， 我 当初 也 是 历经 一 番 坎 坷 才 理 解 的 。 多 读 几 遍 代 码 和 功能 测试 ， 慢 慢 体 会 。 如 果 还 

是 不 能 理解 ， 也 别 烦忧 ， 在 使 用 的 过 程 中 慢 慢 领会 。 本 书 将 多 次 使 用 函数 式 编程 ， 你 会 领 

略 它 的 强大 之 处 的 。 


12.3 ” 补 完 功能 测试 


把 功能 测试 补 完 : 

















functional tests/test list item validation.py (ch111012) 


# 首页 刷新 了 ， 显 示 一 条 错误 消息 

# 提示 待 办 事项 不 能 为 空 

self.wait for(lambda: self.assertEqual( 
self.browser.find element by css selector('.has-error').text, 
"You can't have an empty list item" 


























)) 


# 她 输入 一 些 文 字 ， 然 后 再 次 提交 ， 这 次 没 问题 了 
self.browser.find element by id('id new item').send keys('Buy milk') 
self.browser.find element by id('id new item').send keys(Keys.ENTER) 
self.wait for row in list table('1: Buy milk') 


# 她 有 点 儿 调 皮 ， 又 提交 了 一 个 空 待 办 事项 
self.browser.find element by id('id new item').send keys(Keys.ENTER) 




















# 她 在 列表 页 面 看 到 了 一 条 类 似 的 错误 消息 

self.wait for(lambda: self.assertEqual( 
self.browser.find element by css selector('.has-error').text, 
"You can't have an empty list item" 








)) 
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# 输入 文字 之 后 就 没 问 题 了 
self.browser.find element by id('id new item').send keys('Make tea') 
self.browser.find element by id('id new item').send keys(Keys.ENTER) 
self.wait for row in list table('1: Buy milk') 
self.wait for row in list table('2: Make tea') 





功能 测试 中 的 辅助 方法 
至 此 ， 我 们 定义 了 两 个 辅助 方法 : self.wait for 和 wait for row in list table, jj 
者 是 通用 的 ， 任 何 功能 测试 都 可 能 需要 等 待 。 


后 者 还 有 助 于 避免 功能 测试 出 现 重 复 的 代码 。 如 果 有 一 天 我 们 决定 改变 清单 表格 的 实 
只 需 修改 一 个 地 方 ， 而 不 用 在 功能 测试 中 四 处 修改 。 


第 25 章 和 附录 刁 还 将 深入 讨论 如 何 合理 规划 功能 测试 。 














这 次 提交 留 给 你 自己 完成 ， 这 是 你 第 一 次 独立 提交 功能 测试 。 


12.4 重 构 单元 测试 ， 分 拆 成 多 个 文件 

最 终 开始 编写 代码 前 ， 要 为 模型 编写 一 个 新 测试 ， 但 在 此 之 前 ， 先 要 使 用 类 似 于 功能 测试 
的 整理 方法 整理 单元 测试 。 

但 这 一 次 有 所 不 同 ， 因 为 lists 应 用 中 既 有 应 用 代码 也 有 测试 代码 ， 所 以 要 把 测试 放 到 单 
独 的 文件 夹 中 : 



































$ mkdir lists/tests 

$ touch lists/tests/ init .py 

$ git mv lists/tests.py lists/tests/test all.py 
$ git status 

$ git add lists/tests 

$ python manage.py test lists 

[...] 

Ran 9 tests in 0.034s 


OK 
$ git commit -m "Move unit tests into a folder with single file" 


如 果 测 试 的 输出 显示 “Ran 0 tests”"， 有 可 能 是 因为 你 忘 了 创建 init py 文件 
这 个 文件 ， 否 则 测试 所 在 的 文件 夹 就 不 是 有 效 的 Python 包 。 

现在 把 test all.py 分 成 两 个 文件 : 一 个 名 为 test_views.py， 只 包含 视图 测试 ， 另 一 个 名 为 
test_models.py。 先 复制 两 份 ; 


$ git mv lists/tests/test all.py lists/tests/test views.py 
$ cp lists/tests/test views.py lists/tests/test models.py 


然后 清理 test_models.py， 只 留 下 一 个 测试 方法 ， 所 以 导入 的 模块 也 更 少 了 : 

















必须 有 























lists/tests/test models.py (ch111016) 


from django.test import TestCase 
from lists.models import Item, List 


class ListAndItemModelsTest(TestCase): 


[...] 





test views.py 只 减少 了 一 个 类 : 


lists/tests/test views.py (ch111017) 


--- a/lists/tests/test views.py 

+++ b/lists/tests/test views.py 

@@ -103,34 «104,3 @@ class ListViewTest(TestCase): 
self.assertNotContains(response, 'other list item 1') 
self.assertNotContains(response, 'other list item 2') 


-class ListAndItemModelsTest(TestCase): 


- def test saving and retrieving items(self): 


[...] 

再 次 运行 测试 ， 确 保 一 切 正常 : 
$ python manage.py test lists 
Ro rece dn a diats 
OK 

很 好 ! 


$ git add lists/tests 
$ git commit -m "Split out unit tests into two files" 











欢 在 项 目 一 开始 就 把 单元 测试 放 在 一 个 测试 文件 夹 中 。 这 种 做 法 很 


























必要 时 再 这 么 做 ， 以 免 第 一 章 内 容 过 杂 。 














至 此 ， 功 能 测试 和 单元 测试 的 组 织 方式 更 合理 了 。 下 一 章 将 探讨 验证 规则 。 
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关于 组 织 测试 和 重 构 的 小 贴 十 

把 测试 放 在 单独 的 文件 夹 中 

就 像 使 用 多 个 文件 保存 应 用 代码 一 样 ， 你 也 应 该 把 测试 放 到 多 个 文件 中 。 

€ 对 功能 测试 来 说 ， 按 照 特 定 功能 或 用 户 故 事 的 方式 组 织 。 

+ 对 单元 测试 来 说 ， 使 用 一 个 名 为 tests 的 文件 夹 ， 并 在 其 中 添加 init .py 文件 。 

4 或 许可 以 把 针对 一 个 源码 文件 的 测试 放 在 一 个 单独 的 文件 中 。 在 Django 中 ， 往 
往 有 test_models.py、test_views.py 和 test_forms.py。 

4 每 个 函数 和 类 部 至 少 有 一 个 占 位 测试 。 

别 忘 了 “ 遇 红 / 变 绿 / 重 构 ” 中 的 “ 重 构 ” 

编写 测试 的 主要 目的 是 让 你 重 构 代码 | 一 定 要 重 构 ， 尽 量 让 代码 (包括 测试 ) 变 得 

简洁 。 

测试 失败 时 别 重 构 

4 一 般 情况 下 如 此 。 

€ 不 算 正 在 处 理 的 功能 测试 。 

$ 如果 测 试 的 对 象 还 没 实现 ， 可 以 先 为 测试 方法 加 上 @skip 装饰 器 。 

4 更 常见 的 做 法 是 : 记 下 想 重 构 的 地 方 ， 完 成 手头 上 的 活 儿 ， 等 应 用 处 于 正常 状 
态 时 再 重 构 。 

4 提交 代码 之 前 别 忘 了 删 掉 所 有 @skip 装饰 器 ! 一 定 要 逐 行 审 查 差异 ， 找 出 需要 删 
除 的 每 一 个 地 方 。 

党 试 通用 的 wait_for 辅 助 方法 

使 用 专门 的 辅助 方法 实现 显 式 等 待 是 个 不 错 的 主意 ， 能 让 测试 更 易于 阅读 ， 但 有 时 

单行 断言 或 Selenium 交互 也 需要 等 待 一 段 时 间 。self.wait_for 很 符合 我 的 需求 ， 

不 过 你 可 能 需要 稍微 不 同 的 方式 。 


«il 
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第 13 章 


数据 库 层 验证 





接 下 来 的 几 章 将 实现 并 测试 用 户 输入 验证 。 


这 里 有 相当 一 部 分 内 容 是 专门 针对 Django 的 ， 很 少 涉及 TDD 原理 。 但 这 并 不 意味 着 你 学 
不 到 关于 测试 的 新 知识 一 一 其 实 我 们 将 讨论 很 多 有 趣 的 测试 小 知识 点 ， 但 将 更 关注 如 何 适 
应 测试 、 如 何 跟 上 TDD 的 节奏 以 及 如 何 完成 手 上 的 工作 。 

这 三 章 都 很 短 ， 学 完 之 后 ， 我 们 将 稍微 接触 一 下 JavaScript， 然 后 结束 第 二 部 分 。 第 三 部 分 将 
深入 讨论 TDD 方法 论 的 细节 ， 比 如 比较 单元 测试 和 整合 测试 、 介 绍 模拟 技术 等 。 敬 请 期 待 ! 
不 过 现在 要 稍微 讨论 一 下 验证 。 先 运行 功能 测试 ， 看 一 下 目前 进展 到 哪里 了 : 


$ python3 manage.py test functional tests.test list item validation 


D! Y 


ERROR: test cannot add empty list items 
(functional tests.test list item validation.ItemValidationTest) 
Traceback (most recent call last): 
File "/.../superlists/functional tests/test list item validation.py", line 
15, in test cannot add empty list items 
self.wait for(lambda: self.assertEqual( 
] 


File "/.../superlists/functional tests/test list item validation.py", line 








Ll 














[ 


16, in «lambda» 
self.browser.find element by css selector('.has-error').text, 


[. 2#] 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: .has-error 


功能 测试 指明 ， 用 户 输入 空 待 办 事项 时 ， 期 望 看 到 一 个 错误 消息 。 
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13.1 模型 层 验证 


Web 应 用 的 验证 放 在 两 个 地 方 : 客户 端 〈 稍 后 会 看 到 ， 使 用 的 是 JavaScript 或 HTMLS 属 

TE) 和 服务 器 端 。 在 服务 器 端 验证 更 安全 ， 因 为 一 旦 有 漏洞 或 缺陷 ， 客 户 端 验证 可 以 轻易 
绕 过 。 

在 服务 器 端 ， 尤 其 是 对 Django 而 言 ， 也 有 两 个 地 方 可 以 执行 验证 : 一 个 是 模型 层 ， 一 个 

是 表单 层 ， 位 置 较 高 。 只 要 可 行 ， 我 就 会 使 用 低层 验证 ， 一 方面 因为 我 喜欢 数据 库 和 数据 
完整 性 规则 ， 另 一 方面 因为 在 这 一 层 执 行 验证 更 安全 一 一 你 有 时 会 忘记 使 用 了 哪个 表单 
验证 输入 ， 但 使 用 的 数据 库 不 会 变 。 
























































13.1.1 self.assertRaises 上 下 文 管理 器 


下 面 在 模型 层 编写 一 个 单元 测试 。 在 ListAndItenlodelsTest 中 添加 一 个 新 测试 方法 ， 尝 
试 创建 一 个 空 待 办 事项 。 这 个 测试 与 以 往 不 同 ， 我 们 要 测试 的 是 代码 能 抛 出 异常， 





lists/tests/test models.py (ch111018) 


from django.core.exceptions import ValidationError 


[...] 


class ListAndItemModelsTest(TestCase): 


[...] 


def test cannot save empty list items(self): 
list = List.objects.create() 
item = Item(list-list , text-'') 
with self.assertRaises(ValidationError): 
item.save() 


如 果 刚 接触 Python， 可 能 从 未 见 过 with 语句 。 它 结合 “上 下 文 管理 器 ”一 


起 使 用 ， 包 装 一 段 代 码 ， 这 些 代码 的 作用 往往 是 设置 、 清 理 或 处 理 错 误 。 
Python 2.5 的 发 布 说 明 中 有 很 好 的 解说 。 



































这 是 一 个 新 的 单元 测试 技术 : 如 果 想 检查 做 某 件 事 是 否 会 抛 出 异常 ， 可 以 使 用 self.assertRaises 
上 下 文 管理 器 。 此 外 还 可 写成 : 


try: 

item.save() 

self.fail('The save should have raised an exception') 
except ValidationError: 

pass 


不 过 使 用 with 语句 更 简洁 。 现 在 运行 测试 ， 得 到 预期 失败 : 


item.save() 
AssertionError: ValidationError not raised 
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13.1.2. Django 怪异 的 表现 : 保存 时 不 验证 数据 
我 们 遇 到 了 Django 的 一 个 怪异 表现 。 测 试 本 来 应 该 通过 的 。 阅 读 Django 模型 字段 的 文档 
之 后 ， 你 会 发 现 TextField 的 默认 设置 是 blank=False， 也 就 是 说 文本 字段 应 该 拒绝 空 值 。 


但 为 什么 测试 失败 了 呢 ?” 由 于 稍微 有 违 常理 的 历史 原因 ， 保存 数据 时 Django 的 模型 不 会 
运行 全 部 验证 。 稍 后 我 们 会 看 到 ， 在 数据 库 中 实现 的 约束 ， 保 存 数据 时 都 会 抛 出 异常 ， 但 
SQLite 不 文 持 文本 字段 上 的 强制 空 值 约束 ， 所 以 我 们 调用 save 方法 时 无 效 值 悄 无 声息 地 
通过 了 验证 。 

有 种 方法 可 以 检查 约束 是 否 会 在 数据 库 层 执行 : 如 果 在 数据 库 层 制定 约束 ， 需 要 执行 迁移 
才能 应 用 约束 。 但 是 ，Django 知道 SQLite 不 支持 这 种 约束 ， 所 以 如 果 运 行 makemigrations， 
会 看 到 消息 说 没事 可 做 : 


$ python manage.py makemigrations 
No changes detected 


不 过 ，Django 提供 了 一 个 方法 用 于 运行 全 部 验证 ， 即 fuLL_ctean。 下 面 我 们 把 这 个 方法 加 
入 测试 ， 看 看 是 否 有 用 : 




































































lists/tests/test models.py 


with self.assertRaises(ValidationError): 
item.save() 
item.full clean() 


加 入 之 后 ， 测 试 就 通过 了 : 
OK 


很 好 ! 我 们 通过 这 个 怪异 的 表现 学 到 了 一 些 Django 的 验证 知识 。 如 果 忘 了 需求 ， 把 text 
字段 的 约束 条 件 设 为 blank=True ( 试 一 下 吧 )， 测 试 可 以 提醒 我 们 。 


13.2 ”在 视图 中 显示 模型 验证 错误 


下 面 尝 试 在 视图 中 处 理 模型 验证 ， 并 把 验证 错误 传 和 模板， 让 用 户 看 到 。 在 HTML d 8 3€ 
择 地 显示 错误 可 以 使 用 这 种 方法 一 一 检查 是 否 有 错误 变量 传人 模板 ， 如 果 有 就 在 表单 下 方 


| = Ne 
显示 出 来 : 








7 




















lists/templates/base.html (ch111020) 


«form method="POST" action="{% block form action %}{% endblock %}"> 
«input name="item text" id-"id new item" 
Cclass-"form-control input-lg" 
placeholder-2"Enter a to-do item" /> 
{% csrf token %} 
{% if error %} 
«div class-"form-group has-error"» 
«span class-"help-block"»([ error }}</span> 
</div> 
{% endif %} 
</form> 
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关于 表单 控件 的 更 多 信息 请 阅读 Bootstrap 文档 。 

把 错误 传 入 模板 是 视图 函数 的 任务 。 看 一 下 NewListTest 类 中 的 单元 测试 ， 这 里 我 要 使 用 
两 种 稍微 不 同 的 错误 处 理 模 式 。 

在 第 一 种 情况 中 ， 新 建 清单 视图 有 可 能 泻 染 首页 所 用 的 模板 ， 而 且 还 会 显示 错误 消息 。 单 
元 测试 如 下 : 












































lists/tests/test views.py (ch111021) 


class NewListTest(TestCase): 


E 


def test validation errors are sent back to home page template(self): 
response = self.client.post('/lists/new', data-('item text': ''}) 
self.assertEqual(response.status code, 200) 
self.assertTemplateUsed(response, 'home.html') 
expected error - "You can't have an empty list item" 
self.assertContains(response, expected error) 


编写 这 个 测试 时 ， 我 们 手动 输入 了 字符 串 形 式 的 地 址 /istsnew， 你 可 能 有 点 反感 。 在 此 
之 前 ， 我 们 已 经 在 测试 、 视 图 和 模板 中 硬 编码 了 多 个 地 址 ， 这 么 做 有 违 DRY 原则 。 我 并 
不 介意 测试 中 有 少量 重复 ， 但 视图 和 模板 中 硬 编码 的 地 址 要 引起 重视 ， 请 在 便签 上 做 个 记 
录 ， 稍 后 重 构 这 些 地 址 。 我 们 不 会 立即 开始 重 构 ， 因 为 现在 应 用 无 法 正常 运行 ， 得 先 让 应 
用 回 到 可 运行 的 状态 。 

再 看 测试 。 现 在 测试 无 法 通过 ， 因 为 现在 视图 返回 302 重 定向 ， 而 不 是 正常 的 200 响应 : 


AssertionError: 302 != 200 


我 们 在 视图 中 调用 full_clean() 试 试 : 




















E 









































lists/views.py 


def new list(request): 
list = List.objects.create() 
item - Item.objects.create(text-request.POST['item text'], list-list ) 
item.full clean() 
return redirect(f'/lists/[list .id)/') 


看 到 这 个 视图 的 代码 ， 我 们 找到 了 一 种 避免 硬 编码 URL 的 好 方法 。 把 这 件 事 记 在 便签 上 : 











。 去 除 views.py 中 硬 编码 的 URL 
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现在 模型 验证 会 抛 出 异常 ， 并 且 传 到 了 视图 中 : 
[...] 


File "/.../superlists/lists/views.py", line 11, in new list 
item.full clean() 





[escl 
django.core.exceptions.ValidationError: {'text': ['This field cannot be 
blank. ']} 














下 面 使 用 第 一 种 错误 处 理 方案 : 使 用 try/except 检测 错误 。 遵 从 测试 山羊 的 教诲 ， 只 加 入 
try/except， 其 他 代码 都 不 动 。 测 试 会 告诉 我 们 下 一 步 要 编写 什么 代码 : 


lists/views.py (ch111025) 


from django.core.exceptions import ValidationError 


[2s] 

def new list(request): 
list = List.objects.create() 
item - Item.objects.create(text-request.POST['item text'], list-list ) 
try: 


item.full clean() 
except ValidationError: 
pass 
return redirect(f'/lists/[list .id)/') 


加 入 try/except 之 后 ， 测 试 结果 又 变 成 了 302 != 200 错误 : 


AssertionError: 302 !- 200 


下 面 把 pass Piece Ae E. XX A OERA SEBUPUTI DUE : 

















lists/views.py (ch111026) 


except ValidationError: 
return render(request, 'home.html') 


现在 测试 告诉 我 们 ， 要 把 错误 消息 写 入 模板 : 


AssertionError: False is not true : Couldn't find 'You can't have an empty list 
item' in response 


为 此 ， 可 以 传人 一 个 新 的 模板 变量 : 


lists/views.py (ch111027) 


except ValidationError: 
error = "You can't have an empty list item" 
return render(request, 'home.html', ["error": error}) 


不 过 ， 看 样子 没什么 用 : 


AssertionError: False is not true : Couldn't find 'You can't have an empty list 
item' in response 


让 视图 输出 一 些 信息 以 便 调试 : 
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lists/tests/test views.py 


expected error - "You can't have an empty list item" 
print(response.content.decode()) 
self.assertContains(response, expected error) 


从 输出 的 信息 中 我 们 得 知 ， 失 败 的 原因 是 Django 转 义 了 HTML 中 的 单 引 号 : 

















[51 
«span class-"help-block"2You can&#39;t have an empty list 
item«/span» 
可 以 在 测试 中 写 入 : 
expected error = "You can&#39;t have an empty list item" 





但 使 用 Django 提供 的 辅助 函数 或 许 是 更 好 的 方法 : 


lists/tests/test views.py (ch111029) 


from django.utils.html import escape 


[ed 


expected error = escape("You can't have an empty list item") 
self.assertContains(response, expected error) 


测试 通过 了 : 
Ran 11 tests in 0.047s 


OK 


确保 无 效 的 输入 值 不 会 存 入 数据 库 
继续 做 其 他 事 之 前 ， 不 知 你 是 否 注意 到 了 我 们 的 实现 有 点 逻辑 错误 ?现在 即使 验证 失败 仍 
会 创建 对 象 : 





lists/views.py 


item - Item.objects.create(text-request.POST['item text'], list-list ) 
try: 

item.full clean() 
except ValidationError: 


E 
要 添加 一 个 新 单元 测试 ， 确 保 不 会 保存 空 待 办 事项 : 


lists/tests/test views.py (ch111030-1) 


class NewListTest(TestCase): 


[...] 


def test validation errors are sent back to home page template(self): 


[...] 


def test invalid list items arent saved(self): 





self.client.post('/lists/new', data-('item text': ''}) 
self.assertEqual(List.objects.count(), 0) 
self.assertEqual(Item.objects.count(), 0) 


测试 的 结果 是 : 
[...] 


Traceback (most recent call last): 
File "/.../superlists/lists/tests/test views.py", line 40, in 
test invalid list items arent saved 
self.assertEqual(List.objects.count(), 0) 


AssertionError: 1 !- 0 
修正 的 方法 如 下 : 


lists/views.py (ch111030-2) 


def new list(request): 


list = List.objects.create() 
item - Item(text-request.POST['item text'], list-list ) 
try: 


item.full clean() 

item.save() 
except ValidationError: 

list .delete() 

error - "You can't have an empty list item" 

return render(request, 'home.html', ["error": error}) 
return redirect(f'/lists/[list .id)/') 


功能 测试 能 通过 吗 ? 


$ python manage.py test functional tests.test list item validation 


[553] 
File "/.../superlists/functional tests/test list item validation.py", line 
29, in test cannot add empty list items 

self.wait for(lambda: self.assertEqual( 


Pa] 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: .has-error 


不 能 完全 通过 ， 但 取得 了 一 些 进展 。 从 line 29 那 行 能 看 出 ， 功 能 测试 的 第 一 部 分 通过 了 ， 
现在 要 处 理 第 二 部 分 ， 即 第 二 次 提交 空 待 办 事项 也 要 显示 错误 消息 。 


不 过 我 们 编写 了 一 些 可 用 的 代码 ， 那 就 做 个 提交 吧 ， 


$ git commit -am "Adjust new list view to do model validation" 


13.8 ”Django 模式 : 在 泻 染 表单 的 视图 中 处 理 


POST 请 求 


这 一 次 要 使 用 一 种 稍微 不 同 的 处 理 方式 ， 这 种 方式 是 Django 中 十 分 常用 的 模式 : fed 
表单 的 视图 中 处 理 该 视图 接收 到 的 POST 请 求 。 这 么 做 虽然 不 太 符 合 REST 架构 的 URL 规 
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则 ， 却 有 个 很 大 的 好 处 : 同一 个 URL 既 可 以 显示 表单 ， 又 可 以 显示 处 理 用 户 输入 过 程 中 
遇 到 的 错误 。 

现在 的 状况 是 ， 显 示 清 单 用 一 个 视图 和 URL， 处 理 新 建 清单 中 的 竺 办 事项 用 另 一 个 视图 和 
URL。 要 把 这 两 种 操作 合并 到 一 个 视图 和 URL 中 。 所 以 ， 在 list.html 中 ， 表 单 的 提交 目标 























lists/templates/list.html (ch111030) 
{% block form action %}/lists/{{ list.id }}/{% endblock %} 


不 小 心 又 硬 编码 了 一 个 URL， 在 便签 上 记 下 这 个 地 方 。 回 想 一 下 ，home.html 中 也 有 一 个 : 



















。 去 除 Views.py 中 硬 编 码 的 URL 
。 去 除 list.html 的 表单 和 home.html 中 硬 编 码 的 URL 











PO 


修改 之 后 功能 测试 随即 失败 ， 因 为 view_list 视图 还 不 知道 如 何 处 理 POST 请 求 : 


$ python manage.py test functional tests 

















selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: .has-error 

Lees] 

AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Buy 
peacock feathers'] 








本 节 要 进行 一 次 应 用 层 的 重 构 。 在 应 用 层 中 重 构 时 ， 要 先 修改 或 增加 单元 测 
试 , 然后 再 调整 代码 。 使 用 功能 测试 检查 重 构 是 否 完成 ， 以 及 一 切 能 否 像 重 
构 前 一 样 正常 运行 。 如 果 你 想 完全 理解 这 个 过 程 ， 请 再 看 一 下 第 4 章 末尾 的 
图 表 。 














13.3.1 Æ}: 把 new_item 实 现 的 功能 移 到 view_tlist 中 


NewItenTest 类 中 的 测试 用 于 检查 把 POST 请 求 中 的 数据 保存 到 现 有 的 清单 中 ， 把 这 些 
测试 全 部 移 到 ListviewTest 类 中 ， 还 要 把 原来 的 请 求 目 标 地 址 .../add_item 改 成 显示 请 
单 的 URL: 
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lists/tests/test views.py (ch111031) 


class ListViewTest(TestCase): 


def test uses list template(self): 


[52] 

def test passes correct list to template(self): 
[255] 

def test displays only items for that list(self): 
[5] 


def test can save a POST request to an existing list(self): 
other list = List.objects.create() 
correct list = List.objects.create() 


self.client.post( 
f'/lists/(correct list.idj/', 
data-('item text': 'A new item for an existing list') 


) 


self.assertEqual(Item.objects.count(), 1) 

new item - Item.objects.first() 

self.assertEqual(new item.text, 'A new item for an existing list') 
self.assertEqual(new item.list, correct list) 


def test POST redirects to list view(self): 
other list - List.objects.create() 
correct list = List.objects.create() 


response = self.client.post( 
f'/lists/(correct list.idj/', 
data-('item text': 'A new item for an existing list'} 


) 


self.assertRedirects(response, f'/lists/[correct list.id)/') 


注意 ， 整 个 NewItemTest 类 都 没有 了 。 而 且 我 还 修改 了 重 定向 测试 方法 的 名 字 ， 明 确 表明 
只 适用 于 POST 请 求 。 


改动 之 后 测试 的 结果 为 : 


FAIL: test POST redirects to list view (lists.tests.test views.ListViewTest) 


AssertionError: 200 !- 302 : Response didn't redirect as expected: Response 
code was 200 (expected 302) 
[s] 


FAIL: test can save a POST request to an existing list 
(lists.tests.test views.ListViewTest) 
AssertionError: 0 !- 1 


然后 修改 view list 图 数 ， 处 理 两 种 请 求 类 型 


lists/views.py (ch111032-1) 
def view list(request, list id): 
list = List.objects.get(id-list id) 
if request.method -- 'POST': 
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Item.objects.create(text-request.POST['item text'], list-list ) 
return redirect(f'/lists/[list .id)/') 
return render(request, 'list.html', ['list': list }) 


修改 之 后 测试 通过 了 : 
Ran 12 tests in 0.047s 
OK 

现在 可 以 删除 add item 视图 ， 因 为 不 再 需要 了 。 但 出 平 意料 ， 一 些 测试 失败 了 : 
ER 


AttributeError: module 'lists.views' has no attribute 'add_item' 


失败 的 原因 是 ， 虽 然 删除 了 视图 ， 但 在 urls.py 中 仍然 引用 这 个 视图 。 把 引用 也 删除 : 











lists/urls.py (ch111033) 


urlpatterns - [ 
url(r'^newS', views.new list, name-'new list'), 
url(r'^(\d+)/$', views.view list, name-'view list'), 


] 
这 样 单元 测试 就 能 通过 了 。 运 行 所 有 功能 测试 看 看 结果 如 何 : 


$ python manage.py test 
[...] 


ERROR: test cannot add empty list items 


[4] 




















Ran 16 tests in 15.276s 
FAILED (errors-1) 


依然 是 那个 新 功能 测试 中 的 失败 。 至 此 ， 重 构 add item 功能 的 任务 完成 了 。 此 时 应 该 提交 
代码 : 
$ git commit -am "Refactor list view to handle new item POSTs" 
我 是 不 是 破坏 了 “有 测试 失败 时 不 重 构 ” 这 个 规则 ? 本 节 可 以 这 么 做 ， 因 为 


若 想 使 用 新 功能 必须 重 构 。 如 果 有 单元 测试 失败 ， 决 不 能 重 构 。 不 过 在 本 书 
中 ， 虽 然 当前 这 个 用 户 故 事 的 功能 测试 失败 了 ， 但 仍然 可 以 重 构 。 ' 



































13.3.2 在 view_List 视 图 中 执行 模型 验证 


把 待 办 事项 添加 到 现 有 清单 时 ， 我 们 希望 保存 数据 时 仍 能 遵守 制定 好 的 模型 验证 规则 。 为 
此 要 编写 一 个 新 单元 测试 ， 和 首页 的 单元 测试 差不多 ,但 有 几 处 不 同 : 














Hd: 如 果 你 更 想 看 到 一 个 干净 的 测试 结果 ， 那 么 可 以 为 这 个 功能 测试 方法 加 上 @skip 装饰 器 ， 或 者 在 测试 方 
法 中 尽早 返回 。 但 是 ， 别 忘 了 你 这 么 做 过 。 


























lists/tests/test views.py (ch111034) 


class ListViewTest(TestCase): 


[ee] 


def test validation errors end up on lists page(self): 
list = List.objects.create() 
response = self.client.post( 
f'/lists/(list .id)/', 
data-('item text': '') 
) 
self.assertEqual(response.status code, 200) 
self.assertTemplateUsed(response, 'list.html') 
expected error = escape("You can't have an empty list item") 
self.assertContains(response, expected error) 


这 个 测试 应 该 失败 ， 因 为 视图 现在 还 没 做 任何 验证 ， 只 是 重 定向 所 有 POST 请 求 : 


self.assertEqual(response.status code, 200) 
AssertionError: 302 !- 200 


到 中 执行 验证 的 方法 如 下 : 























Bi 
党 
S 














lists/views.py (ch111035) 


def view list(request, list id): 
list = List.objects.get(id-list id) 
error - None 


if request.method -- 'POST': 

try: 
item - Item(text-request.POST['item text'], list-list ) 
item.full clean() 
item.save() 
return redirect(f'/lists/[list .id)/') 

except ValidationError: 
error = "You can't have an empty list item" 


return render(request, 'list.html', ['list': list , 'error': errorj) 


对 这 段 代 码 不 是 特别 满意 ， 是 吧 ? 确实 有 一 些 重 复 的 代码 ，views.py 中 出 现 了 两 次 
try/except 语句 ， 一 般 来 说 不 太 好 看 。 


Ran 13 tests in 0.047s 





OK 


稍 等 一 会 儿 再 重 构 ， 因 为 我 们 知道 验证 待 办 事项 重复 的 代码 有 点 不 同 。 先 
签 上 : 


























这 件 事 记 在 便 





(CH 
t 
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。 去 除 views.py 中 硬 编 码 的 URL 
。 去 除 listhtml 的 表单 和 home.html 中 硬 编 码 的 URL 
。 去 除 视 图 中 验证 逻辑 里 的 重复 








pA 


制定 “ 事 不 过 三 ， 三 则 重 构 ” 这 个 规则 的 原因 之 一 是 ， 只 有 遇 到 三 次 且 每 次 
都 稍 有 不 同时 ， 才 能 更 好 地 提炼 出 通用 功能 。 如 果 过 早 重 构 ， 得 到 的 代码 可 
能 并 不 适用 于 第 三 次 。 









































至 少 功能 测试 又 可 以 通过 了 
$ python manage.py test functional tests 


[5 
OK 


又 回 到 了 可 正常 运行 的 状态 ， 因 此 可 以 看 一 下 便签 上 的 记录 了 。 现 在 是 提交 的 好 时 机 。 或 
许 还 可 以 喝 杯 茶 休 息 一 下 。 


$ git commit -am "enforce model validation in list view" 


13.4 重 构 : 去 除 硬 编码 的 URL 


还 记得 urls.py 中 name= 参数 的 写法 吗 ? 我 们 是 直接 从 Django 生成 的 默认 URL 映射 中 复制 
过 来 ， 然 后 又 给 它们 起 了 有 意义 的 名 字 。 现 在 要 查 明 这 些 名 字 有 什么 用 。 








lists/urls.py 


url(r'^new$', views.new list, name-'new list'), 
url(r'^(\d+)/$', views.view list, name-'view list'), 


13.4.1 模板 标签 {% url %} 
可 以 把 home html 中 硬 编码 的 URL 换 成 一 个 Django 模板 标签 ， 再 引用 URL 的 “名 字 ”; 




















lists/templates/home.html (ch111036-1) 
{% block form action %}{% url 'new list' %}{% endblock %} 


然后 确认 改动 之 后 不 会 导致 单元 测试 失败 : 
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$ python manage.py test lists 
OK 


继续 修改 其 他 模板 。 传 人 了 一 个 参数 ， 所 以 这 一 个 更 有 趣 : 





lists/templates/list.html (ch111036-2) 
{% block form action %}{% url 'view list' list.id %}{% endblock %} 
详情 请 阅读 Django 文档 中 对 URL CP] AEPrRJAT 28. 
再 次 运行 测试 ， 确 保 都 能 通过 : 


$ python manage.py test lists 
OK 


$ python manage.py test functional_tests 
OK 


太 棒 了 ， 做 次 提交 : 


$ git commit -am "Refactor hard-coded URLs out of templates" 














。 去 除 views.py 中 硬 编码 的 URL 
。 去 除 视 图 中 验证 逻辑 里 的 重复 














pp 和 AAA 











13.4.2” 重 定向 时 使 用 get_absolute_url 


下 面 来 处 理 views.py。 在 这 个 文件 中 去 除 硬 编码 的 URL， 可 以 使 用 和 模板 一 样 的 方法 一 一 
BA URL 的 名 字 和 一 个 位 置 参数 ， 





lists/views.py (ch111036-3) 


def new list(request): 


[s] 


return redirect('view list', list .id) 


修改 之 后 单元 测试 和 功能 测试 仍 能 通过 ， 但 是 redirect 函数 的 作用 远 比 这 强大 。 在 
Django 中 ， 每 个 模型 对 象 都 对 应 一 个 特定 的 URL， 因 此 可 以 定义 一 个 特殊 的 函数 ， 命 名 
为 get_absolute_url， 其 作用 是 获取 显示 单个 模型 对 象 的 页 面 URL。 这 个 函数 在 这 里 很 
有 用 ， 在 Django 管理 后 台 (本 书 不 会 介绍 管理 后 台 ， 但 稍 后 你 可 以 自己 学 习 ) 也 很 有 用 : 
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在 后 台 查 看 一 个 对 象 时 可 以 直接 跳 到 前 台 显 示 该 对 象 的 页 面 。 如 果 有 必要 ， 我 总 是 建议 在 
模型 中 定义 get absolute url 国 数 ， 这 花 不 了 多 少时 间 。 


先 在 test_models.py 中 编写 一 个 超级 简单 的 单元 测试 : 





lists/tests/test models.py (ch111036-4) 
def test get absolute url(self): 

















list = List.objects.create() 
self.assertEqual(list .get absolute url(), f'/lists/(list .idj/') 
得 到 的 测试 结果 是 : 


AttributeError: 'List' object has no attribute 'get absolute url' 


实现 这 个 函数 时 要 使 用 Django 中 的 reverse 函数 。reverse 函数 的 功能 和 Django 对 urls.py 
所 做 的 操作 相反 。 


lists/models.py (ch111036-5) 


from django.core.urlresolvers import reverse 


class List(models.Model): 


def get absolute url(self): 
return reverse('view list', args-[self.id]) 





现在 可 以 在 视图 中 使 用 get_absolute_url 国 数 了 一 一 只 需 把 重 定向 的 目标 对 象 传 给 
redirect 国 数 即 可 ，redirect 国 数 会 自动 调用 get absolute url 国 数 。 


lists/views.py (ch111036-6) 

















def new list(request): 


[ss] 


return redirect(list ) 
更 多 信息 参见 Django 文档 。 快 速 确认 一 下 单元 测试 是 否 仍 能 通过 : 
OK 


然后 使 用 同样 的 方法 修改 view Ust 视图 : 














lists/views.py (ch111036-7) 


def view list(request, list id): 


ERIT 


item.save() 
return redirect(list ) 
except ValidationError: 
error - "You can't have an empty list item" 


分 别 运行 全部 单元 测试 和 功能 测试 ， 确 保 一 切 仍 能 正常 运行 : 








$ python3 manage.py test lists 

OK 

$ python3 manage.py test functional tests 
OK 


把 已 解决 问题 从 便签 上 划 掉 : 











。 去 除 视 图 中 验证 逻辑 里 的 重复 
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$ git commit -am "Use get absolute url on List model to DRY urls in views 
这 一 阶段 结束 ! 我 们 添加 了 模型 层 验证 ， 而 且 在 此 过 程 中 借 机 重 构 了 几 个 地 方 。 
最 后 一 个 待 办 事项 是 下 一 章 的 话题 。 


























关于 数据 库 层 验证 

我 喜欢 尽量 把 验证 逻辑 放 在 低层 ，。 

。 数据 库 层 验证 是 数据 完整 性 的 最 终 保障 
不 管 数据 库 层 之 上 的 各 层 代码 有 多 么 复杂 ， 在 最 低层 验证 能 保证 数据 是 有 效 的 ， 而 
且 是 一 致 的 。 

。 但 是 数据 库 层 验证 有 失灵 活性 
优点 往往 都 伴随 着 缺点 。 添 加 数据 库 层 验证 之 后 ， 就 无 法 得 到 不 一 致 的 数据 了 ， 即 
便 想 暂时 这 么 做 也 不 可 能 。 但 我 们 有 时 就 需要 存储 暂时 破坏 这 些 规则 的 数据 (例如 
在 很 多 阶段 可 能 想 从 外 部 源 导 入 数据 ) ， 毕 竟 有 数据 总 比 没 数 据 强 。 

。 对 用 户 不 太 友好 
尝试 存储 无 效 数据 会 导致 数据 库 返 回 不 友善 的 IntegrityError， 这 可 能 会 让 用 户 看 
到 令 人 困惑 的 500 错误 页 面 。 后 面 的 章节 会 讲 到 ， 表 单 层 验证 考虑 到 了 用 户 ， 不 会 
直接 报错 ， 而 是 显示 友好 的 错误 消息 。 
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第 14 章 


简单 的 表单 





前 一 章 结 尾 提 到 ， 视 图 中 处 理 验 证 的 代码 有 太 多 重复 。Django 鼓励 使 用 表单 类 验证 用 户 的 
输入 ， 以 及 选择 显示 错误 消息 。 本 章 介绍 如 何 使 用 这 种 功能 。 


除 此 之 外 本 章 还 会 花 点 时 间 整 理 单元 测试 ， 确 保 一 个 单元 测试 一 次 只 测试 一 件 事 。 


14.1 把 验证 逻辑 移 到 表单 中 











在 Django 中 ， 视 图 很 复杂 就 说 明 有 代码 异味 。 你 要 想 ， 能 否 把 逻辑 移 到 表 
单 或 模型 类 的 方法 中 ， 或 者 把 业务 逻辑 移 到 Django 之 外 的 模型 中 ? 




















Django 中 的 表单 功能 很 多 很 强大 。 

。 可 以 处 理 用 户 输入 ， 并 验证 输入 值 是 否 有 错误 。 

。 可 以 在 模板 中 使 用 ， 用 来 演 染 HTML input 元 素 和 错误 消息 。 

。 稍 后 会 见识 到 ， 某 些 表 单 甚至 还 可 以 把 数据 存 和 数据库。 

没 必 要 在 每 个 表单 中 都 使 用 这 三 种 功能 。 你 可 以 自己 编写 表单 的 HIML， 或 者 自己 处 理 数 
据 存储 ， 但 表单 是 放置 验证 逻辑 的 绝 佳 位 置 。 
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14.1.1. 使 用 单元 测试 探索 表单 API 

我 们 要 在 一 个 单元 测试 中 实验 表单 的 用 法 。 我 的 计划 是 逐步 迭代， 最 终 得 到 一 个 完整 的 解 
决 方案 。 希 望 在 这 个 过 程 中 能 由 浅 入 深 地 介绍 表单 ， 即 便 你 以 前 从 未 用 过 也 能 理解 。 
首先 ， 新 建 一 个 文件 ， 用 于 编写 表单 的 单元 测试 。 先 编写 一 个 测试 方法 ， 检 查 表单 的 HTML; 














lists/tests/test forms.py 


from django.test import TestCase 


from lists.forms import ItemForm 


class ItemFormTest(TestCase): 


def test form renders item text input(self): 
form = ItemForm() 
self.fail(form.as p()) 


form.as pO) 的 作用 是 把 表单 浑 染 成 HTML。 这 个 单元 测试 使 用 self.fail 探索 性 编程 。 在 
manage.py shell 会 话 中 探索 编程 也 很 容易 ， 不 过 每 次 修改 代码 之 后 都 要 重新 加 载 。 


下 面 编写 一 个 极 简 的 表单 ， 继 承 自 基 类 Form， 只 有 一 个 字段 item text: 

















7 











lists/forms.py 


from django import forms 


class ItemForm(forms.Form): 
item text - forms.CharField() 


运行 测试 后 会 看 到 一 个 失败 消息 ， 告 诉 我 们 自动 生成 的 表单 HTML 是 什么 样 : 


self.fail(form.as p()) 
AssertionError: «p»«label for-"id item text">Item text:«/label» «input 
type="text" name-"item text" required id-"id item text" /»«/p» 








自动 生成 的 HTML 已 经 和 base.html 中 的 表单 HTML 很 接近 了 ， 只 不 过 没有 placeholder 
属性 和 Bootstrap 的 CSS 类 。 再 编写 一 个 单元 测试 方法 ， 检 查 placeholder 属性 和 CSS 类 : 











lists/tests/test forms.py 


class ItemFormTest(TestCase): 


def test form item input has placeholder and css classes(self): 
form = ItemForm() 
self.assertIn('placeholder-"Enter a to-do item"', form.as p()) 
self.assertIn('class-"form-control input-lg"', form.as p()) 





这 个 测试 会 失败 ， 表 明 我 们 需要 真正 地 编写 一 些 代码 了 。 应 该 怎么 定制 表单 字段 的 内 容 
呢 ? 答案 是 使 用 widget 参数 。 加 入 placeholder 属性 的 方法 如 下 : 
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lists/forms.py 


class ItemForm(forms.Form): 
item text - forms.CharField( 
widget-forms.fields.TextInput(attrs-( 
'placeholder': 'Enter a to-do item', 
p. 
) 


修改 之 后 测试 的 结果 为 : 


AssertionError: 'class-"form-control input-lg"' not found in '«p»«label 
forz"id item text'»Item text:«/label» «input type="text" name-"item text" 
placeholder-"Enter a to-do item" required id-"id item text" /»«/p»' 


继续 修改 : 
lists/forms.py 


widget=forms.fields.TextInput(attrs={ 
'placeholder': 'Enter a to-do item', 
'class': 'form-control input-lg', 


D, 








如 果 表 单 中 的 内 容 很 多 或 者 很 复杂 ， 使 用 widget 参数 定制 很 麻烦 ， 此 时 
可 以 借助 django-crispy-forms 和 django-floppyforms。 

















开发 驱动 测试 : 使 用 单元 测试 探索 性 编程 
上 述 过 程 是 不 是 有 点 像 开发 驱动 测试 ? 偶尔 这 么 做 其 实 没 问题 。 


探索 新 API 时 ， 完 全 可 以 先 抛 开 规则 的 束缚 ， 然 后 再 回 到 严格 的 TDD 流程 中 。 你 可 
以 使 用 交互 式 终端 ， 或 者 编写 一 些 探 索性 代码 (不 过 你 要 答应 测试 山羊 ， 稍 后 会 删 掉 
这 些 代 码 ， 然 后 使 用 合理 的 方式 重 写 ) 。 

其 实 ， 现 在 我 们 只 是 使 用 单元 测试 试验 表单 API， 这 是 学 习 如 何 使 用 API 的 好 方法 。 











14.1.2. 换 用 Django 中 的 ModelForm 类 

接 下 来 呢 ?” 我 们 希望 表单 重用 已 经 在 模型 中 定义 好 的 验证 规则 。Django 提供 了 一 个 特殊 的 
类 ， 用 来 自动 生成 模型 的 表单 ， 这 个 类 是 ModelForm。 从 下 面 的 代码 能 看 出 ， 我 们 要 使 用 
一 个 特殊 的 属性 Meta 配置 表单 : 























lists/forms.py 


from django import forms 


from lists.models import Item 





class ItemForm(forms.models.ModelForm): 


Class Meta: 
model - Item 
fields = ('text',) 
我 们 在 Meta 中 指定 这 个 表单 用 于 哪个 模型 ， 以 及 要 使 用 哪些 字段 。 
ModelForms 很 智能 ， 能 完成 各 种 操作 ， 例 如 为 不 同类 型 的 字段 生成 合适 的 input 类型， 以 及 应 
用 默认 的 验证 。 详 情 参见 文档 (https://docs.djangoproject.com/en/1.11/topics/forms/modelforms/) 。 
现在 表单 的 HTML 不 一 样 了 : 


AssertionError: 'placeholder-"Enter a to-do item"' not found in '«p»«label 
forz"id text'»Text:«/label» «textarea name-"text" cols-"40" rows="10" required 
id="id_text">\n</textarea></p>' 

















placeholder 属性 和 CSS 类 都 不 见 了 ， 而 且 name="item_text" 变 成 了 name="text"。 这 些 变 
化 能 接受 ， 但 普通 的 输入 框 变 成 了 textarea， 这 可 不 是 应 用 UI 想 要 的 效果 。 科 好 ， 和 普 
通 的 表单 类 似 ，ModetLFornm 的 字段 也 能 使 用 widget 参数 定制 : 











lists/forms.py 


class ItemForm(forms.models.ModelForm): 


Class Meta: 
model - Item 
fields = ('text',) 
widgets = ( 
'text': forms.fields.TextInput(attrs-( 
'placeholder': 'Enter a to-do item', 
'class': 'form-control input-lg', 
», 
} 


定制 后 测试 通过 了 。 
14.1.3 ”测试 和 定制 表单 验证 


现在 我 们 看 一 下 ModelForm 是 否 应 用 了 模型 中 定义 的 验证 规则 。 我 们 还 会 学 习 如 何 把 数据 
传 和 表单， 就 像 用 户 输 入 的 一 样 : 








lists/tests/test forms.py (ch111008) 


def test form validation for_blank_items(self): 


form = ItemForm(data-('text': '')) 
form.save() 
测试 的 结果 为 : 


ValueError: The Item could not be created because the data didn't validate. 


很 好 ， 如 果 提 交 空 待 办 事项 ， 表 单 不 会 保存 数据 。 
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现在 看 一 下 表单 能 否 显示 指定 的 错误 消息 。 在 尝试 保存 数据 之 前 检查 验证 是 否 通 过 的 API 
是 is valid 函数 : 


lists/tests/test forms.py (ch111009) 


def test form validation for blank items(self): 
form = ItemForm(data-('text': ''}) 
self.assertFalse(form.is valid()) 
self.assertEqual( 
form.errors['text'], 
["You can't have an empty list item"] 


) 

调用 form.is validO 得 到 的 返回 值 是 True 或 False， 不 过 还 有 个 附带 效果 ， 即 验证 输入 
的 数据 ， 生 成 errors 属性 。errors 是 个 字典 ， 把 字段 的 名 字 映 射 到 该 字段 的 错误 列表 上 
(一 个 字段 可 以 有 多 个 错误 )。 
测试 的 结果 为 : 

AssertionError: ['This field is required.'] != ["You can't have an empty list 

item"] 
Django 已 经 为 显示 给 用 户 查看 的 错误 消息 提供 了 默认 值 。 急 着 开发 Web 应 用 的 话 ， 可 以 
直接 使 用 默认 值 。 不 过 我 们 比较 在 意 ， 想 让 错误 消息 特殊 一 些 。 定 制 错误 消息 可 以 修改 


Meta 的 另 一 个 变量 ，error_messages: 






































lists/forms.py (ch111010) 


class Meta: 
model - Item 
fields = ('text',) 


widgets = ( 
'text': forms.fields.TextInput(attrs-( 
'placeholder': 'Enter a to-do item', 
'class': 'form-control input-lg', 
H, 
} 
error_messages = { 
'text': {'required': "You can't have an empty list item"} 
} 
然后 测试 即 可 通过 : 


OK 
知道 如 何 避 免 让 这 些 错 误 消息 搅乱 代码 吗 ? 使 用 常量 : 


lists/forms.py (ch111011) 
EMPTY ITEM ERROR - "You can't have an empty list item" 
[...] 


error messages = ( 
'text': ('required': EMPTY ITEM ERROR) 





再 次 运行 测试 ， 确 认 能 通过 。 好 的 ， 然 后 修改 测试 


lists/tests/test forms.py (ch111012) 


from lists.forms import EMPTY ITEM ERROR, ItemForm 
[is] 


def test form validation for blank items(self): 
form = ItemForm(data-('text': '')) 
self.assertFalse(form.is valid()) 
self.assertEqual(form.errors['text'], [EMPTY ITEM ERROR]) 


修改 之 后 测试 仍 能 通过 : 


OK 


很 好 。 提 交 : 


$ git status # 会 看 到 lists/forms.py 和 tests/test_forms.py 
$ git add lists 
$ git commit -m "new form for list items" 


14.2 在 视图 中 使 用 这 个 表单 


一 开始 我 想 继续 编写 这 个 表单 ， 除 了 空 值 验证 之 外 再 捕获 唯一 性 验证 错误 。 不 过 ， 精 益 
理论 中 的 “尽早 部 署 ” 有 个 推论 ， 即 “尽早 合并 代码 ”。 也 就 是 说 ， 编 写 表单 可 能 要 人 花 很 
多 时 间 ， 不 断 添加 各 种 功能 一 一 我 知道 这 一 点 是 因为 我 在 撰写 本 章 草 稿 时 就 是 这 么 做 的 ， 
做 了 各 种 工作 ， 得 到 一 个 功能 完善 的 表单 类 ， 但 发 布 应 用 后 才 发 现 大 多 数 功能 实际 并 不 


需要 。 





















































因此 ， 要 尽早 试用 新 编写 的 代码 。 这 么 做 能 避免 编写 用 不 到 的 代码 ， 还 能 尽早 在 现实 的 环 
境 中 检验 代码 。 





我 们 编写 了 一 个 表单 类 ， 它 可 以 泻 染 一 些 HTML， 而且 至 少 能 验证 一 种 错误 一 一 下 面 就 来 
使 用 这 个 表单 吧 ! 既然 可 以 在 base.html 模板 中 使 用 这 个 表单 ， 那 么 在 所 有 视图 中 都 可 以 使 
用 。 


14.2.1 在 处 理 GET 请 求 的 视图 中 使 用 这 个 表单 
先 修改 首页 视图 的 单元 测试 。 我 们 要 编写 一 个 新 测试 ， 检 查 使 用 的 表单 类 型 是 否 正 确 : 






































lists/tests/test views.py (ch111013) 


from lists.forms import ItemForm 


class HomePageTest(TestCase): 








def test uses home template(self): 


[25 £] 
def test home page uses item form(self): 
response - self.client.get('/') 
self.assertIsInstance(response.context['form'], ItemForm) Q9 
©  assertIsInstance 检查 表单 是 否 属于 正确 的 类 。 
测试 的 结果 为 : 
KeyError: 'form' 


因此 ， 要 在 首页 视图 中 使 用 这 个 表 六 























z^ 








lists/views.py (ch111014) 
Ex 


from lists.forms import ItemForm 
from lists.models import Item, List 


def home page(request): 
return render(request, 'home.html', ['form': ItemForm()]) 


好 了 ， 下 面 尝试 在 模板 中 使 用 这 个 表单 一 一 把 原来 的 <input . .> 替换 成 {{ form.text 33: 





lists/templates/base.html (ch111015) 


«form method="POST" action="{% block form action %}{% endblock %}"> 
{{ form.text }} 
{% csrf_token %} 
{% if error %} 
<div class="form-group has-error"> 





{{ form. text }} 只 会 泻 染 这 个 表单 中 的 text 字段 ， 生 成 HTML input 7638. 


14.2.2 ”大 量 查找 和 替换 
前 文 我 们 修改 了 表单 ，id 和 name 属性 的 值 变 了 。 运 行 功 能 测试 时 你 会 看 到 ， 首 次 尝试 查 
找 输入 框 时 测试 失败 了 : 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: [id-"id new item"] 




















我 们 得 修正 这 个 问题 ， 为 此 要 进行 大 量 查找 和 替换 。 在 此 之 前 先 提交 ， 把 重 命名 和 逻辑 变 
动 区 分 开 : 

$ git diff # 审查 base.htmL、views.py 及 其 测试 中 的 改动 

$ git commit -am "use new form in home page, simplify tests. NB breaks stuff" 
下 面 来 修正 功能 测试 。 通 过 grep 命令 ， 我 们 得 知 有 很 多 地 方 都 使 用 了 id new item: 











$ grep id new item functional tests/test* 
functional tests/test layout and styling.py: inputbox - 





self.browser.find element by id('id new item') 

functional tests/test layout and styling.py: inputbox - 
self.browser.find element by id('id new item') 

functional tests/test list item validation.py: 

self.browser.find element by id('id new item').send keys(Keys.ENTER) 
[s] 


这 表明 我 们 要 重 构 。 在 base.py 中 定义 一 个 新 辅助 方法 : 








functional tests/base.py (ch111018) 


class FunctionalTest(StaticLiveServerTestCase): 


[a] 
def get item input box(self): 
return self.browser.find element by id('id text') 
后 所 有 需要 替换 的 地 方 都 使 用 这 个 辅助 方法 一 一 test_simple_list_creation.py 修改 四 处 ， 
pd uu a 








functional tests/test simple list creation.py 





# 应 用 邀请 她 输入 一 个 待 办 事项 
inputbox = self.get item input box() 











以 及 : 


functional tests/test list item_validation.py 


# 输入 框 中 没 输入 内 容 ， 她 就 按 下 了 回 车 键 
self.browser.get(self.live server url) 
self.get item input box().send keys(Keys.ENTER) 


我 不 会 列 出 每 一 处 ， 相 信 你 自己 能 搞定 ! 你 可 以 再 执行 一 遍 grep， 看 是 不 是 全 都 改 了 。 
第 一 步 完 成 了 ， 接 下 来 还 要 修改 应 用 代码 。 我 们 要 找到 所 有 旧 的 id (id new item) 和 
name (item_text)， 分 别 株 换 成 id_text 和 text; 


$ grep -r id new item lists/ 
lists/static/base.css:fid new item { 


只 要 改动 一 处 。 使 用 类 似 的 方法 查看 nane 出 现 的 位 置 : 


$ grep -Ir item text lists 


[555] 



































lists/views.py: item - Item(text-request.POST['item text'], list-list ) 
lists/views.py: item - Item(text-request.POST['item text'], 
list-list ) 

lists/tests/test views.py: self.client.post('/lists/new', 
data-('item text': 'A new list item'}) 

lists/tests/test views.py: response - self.client.post('/lists/new', 


data-('item text': 'A new list item')) 
E] 
lists/tests/test views.py: data-('item text': '') 


[E] 
改 完 之 后 再 运行 单元 测试 ， 确 保 一 切 仍 能 正常 运行 : 
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$ python manage.py test lists 
[4 


Ran 17 tests in 0.126s 
OK 
然后 还 要 运行 功能 测试 : 
$ python manage.py test functional tests 
[5-5 
File "/.../superlists/functional tests/test simple list creation.py", line 
37, in test can start a list for one user 
return self.browser.find element by id('id text') 
File "/.../superlists/functional tests/base.py", line 51, in 
get item input box 
return self.browser.find element by id('id text') 
[5] 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: [id-"id text"] 


[3:557] 
FAILED (errors-3) 


不 能 全 部 通过 。 确 认 一 下 发 生 错误 的 位 置 一 一 查看 其 中 一 个 失败 所 在 的 行 号 ， 你 会 发 现 ， 
每 次 提交 第 一 个 待 办 事项 后 ， 清 单 页 面 都 不 会 显示 输入 框 。 


查看 views.py 和 new_List 视图 后 我 们 找到 了 原因 一 一 如 果 检 测 到 有 验证 错误 ， 根 本 就 不 会 
把 表单 传 入 home.html 模板 : 























lists/views.py 


except ValidationError: 
list .delete() 
error = "You can't have an empty list item" 
return render(request, 'home.html', ["error": error}) 


我 们 也 想 在 这 个 视图 中 使 用 ItemForm 表单 。 继 续 修改 之 前 ， 先 提交 


$ git status 
$ git commit -am "rename all item input ids and names. still broken" 


14.8 在 处 理 POST 请 求 的 视图 中 使 用 这 个 表单 


现在 要 调整 new list 视图 的 单元 测试 ， 更 确切 地 说 ， 要 修改 针对 验证 的 那个 测试 方法 。 先 
看 一 下 这 个 测试 方法 : 





lists/tests/test views.py 
class NewListTest(TestCase): 


[...] 


def test validation errors are sent back to home page template(self): 
response = self.client.post('/lists/new', data-('text': '')) 





self.assertEqual(response.status code, 200) 
self.assertTemplateUsed(response, 'home.html') 

expected error = escape("You can't have an empty list item") 
self.assertContains(response, expected error) 


14.3.1 修改 new_list 视 图 的 单元 测试 
首先 ， 这 个 测试 方法 测试 的 内 容 太 多 了 ， 所 以 借 此 机 会 可 以 清理 一 下 。 我 们 应 该 把 这 个 测 
试 方法 分 成 两 个 不 同 的 断言 。 


。 如 果 有 验证 错误 ， 应 该 泻 染 首页 模板 ， 并且 返回 200 响应 。 
。 如 果 有 验证 错误 ， 响 应 中 应 该 包含 错误 消息 。 


此 外 ， 还 可 以 添加 一 个 新 断言 。 
。 如 果 有 验证 错误 ， 应 该 把 表单 对 象 传人 模板 。 
不 用 硬 编码 错误 消息 字符 串 ， 而 要 使 用 一 个 常量 : 
























































lists/tests/test views.py (ch111023) 


from lists.forms import ItemForm, EMPTY ITEM ERROR 
[y] 


class NewListTest(TestCase): 


[...] 


def test for invalid input renders home template(self): 
response = self.client.post('/lists/new', data-('text': ''}) 
self.assertEqual(response.status code, 200) 
self.assertTemplateUsed(response, 'home.html') 


def test validation errors are shown on home page(self): 
response = self.client.post('/lists/new', data-('text': '')) 
self.assertContains(response, escape(EMPTY ITEM ERROR)) 


def test for invalid input passes form to template(self): 
response = self.client.post('/lists/new', data-('text': ''}) 
self.assertIsInstance(response.context['form'], ItemForm) 


现在 好 多 了 ， 每 个 测试 方法 只 测试 一 件 事 。 如 果 幸 运 的 话 ， 只 有 一 个 调试 会 失败 ， 而 且 会 
告诉 我 们 接 下 来 做 什么 : 


$ python manage.py test lists 


[...] 


ERROR: test for invalid input passes form to template 
(lists.tests.test views.NewlListTest) 
Traceback (most recent call last): 

File "/.../superlists/lists/tests/test views.py", line 49, in 
test for invalid input passes form to template 





pun 
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self.assertIsInstance(response.context['form'], ItemForm) 


Ex] 


KeyError: 'form' 


Ran 19 tests in 0.041s 


FAILED (errors-1) 


14.3.2 ”在 视图 中 使 用 这 个 表单 
在 视图 中 使 用 这 个 表单 的 方法 如 下 : 











lists/views.py 


def new list(request): 

form = ItemForm(data-request.POST) ©@ 

if form.is valid(): 6 
list = List.objects.create() 
Item.objects.create(text-request.POST['text'], list-list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', ["form": form) © 


© i request. POST 中 的 数据 传 给 表单 的 构造 方法 。 
@ {EM form.is valid() 判断 提交 是 否 成 功 。 
@ ”如 果 提 交 失 败 ， 把 表单 对 象 传 入 模板 ， 而 不 显示 一 个 硬 编码 的 错误 消息 字符 串 。 
视图 现在 看 起 来 更 完美 了 。 而 且 除 了 一 个 测试 之 外 ， 其 他 测试 都 能 通过 : 
EL MM DE escape(EMPTY ITEM ERROR)) 


AssertionError: False is not true : Couldn't find 'You can&#39;t have an empty 
list item' in response 


14.8.3 ”使 用 这 个 表单 在 模板 中 显示 错误 消息 


测试 失败 的 原因 是 模板 还 没 使 用 这 个 表单 显示 错误 消息 : 


























lists/templates/base.html (ch111026) 


«form method="POST" action="{% block form action %}{% endblock %}"> 
{{ form.text }} 
{% csrf_token %} 
(X if form.errors *) © 
«div class-"form-group has-error"> 
«div class-"help-block"2»[( form.text.errors }}</div> 69 
</div> 
{% endif %} 
</form> 


@ form.errors 是 一 个 列表 ， 包 含 这 个 表单 中 的 所 有 错误 。 


O  form.text.errors 也 是 一 个 列表 ， 但 只 包含 text 字段 的 错误 。 














这 样 修改 之 后 对 测试 有 什么 作用 呢 ? 


FAIL: test validation errors end up on lists page 
(lists.tests.test views.ListViewTest) 


Eis:] 

AssertionError: False is not true : Couldn't find 'You can&#39;t have an empty 
list item' in response 

得 到 了 一 个 意料 之 外 的 失败 ， 这 次 失败 发 生 在 针对 最 后 一 个 试图 view list 的 测试 中 。 因 

为 我 们 修改 了 错误 在 所 有 模板 中 显示 的 方式 ， 不 再 显示 手动 传人 模板 的 错误 。 


因此 ， 还 要 修改 view list 视图 才能 重新 回 到 可 运行 状态 。 


14.4 在 其 他 视图 中 使 用 这 个 表单 


view list 视图 既 可 以 处 理 GET 请 求 也 可 以 处 理 POST 请 求 。 先 测试 GET 请 求 ， 为 此 ， 可 
以 编写 一 个 新 测试 方法 : 













































































lists/tests/test views.py 


class ListViewTest(TestCase): 


[s] 
def test displays item form(self): 
list = List.objects.create() 


response = self.client.get(f'/lists/[list .id)/') 
self.assertIsInstance(response.context['form'], ItemForm) 
self.assertContains(response, 'name-"text"') 


测试 的 结果 为 : 
KeyError: 'form' 


解决 这 个 问题 最 简单 的 方法 如 下 : 





lists/views.py (ch111028) 


def view list(request, list id): 
[E 
form = ItemForm() 
return render(request, 'list.html', { 
'list': list , "form": form, "error": error 


n 


14.4.1 定义 辅助 方法 ， 简 化 测试 
接 下 来 要 在 另 一 个 视图 中 使 用 这 个 表单 的 错误 消息 ， 把 当前 针对 表单 提交 失败 的 测试 
(test validation errors end up on lists page) 分 成 多 个 测试 方法 : 

















lists/tests/test views.py (ch111030) 


class ListViewTest(TestCase): 


[cc] 
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def post invalid input(self): 
list = List.objects.create() 
return self.client.post( 
f'/lists/(list .id)/', 
data-(['text': '') 
) 


def test for invalid input nothing saved to db(self): 
self.post invalid input() 
self.assertEqual(Item.objects.count(), 0) 


def test for invalid input renders list template(self): 
response - self.post invalid input() 
self.assertEqual(response.status code, 200) 
self.assertTemplateUsed(response, 'list.html') 


def test for invalid input passes form to template(self): 
response - self.post invalid input() 
self.assertIsInstance(response.context['form'], ItemForm) 


def test for invalid input shows error on page(self): 
response - self.post invalid input() 
self.assertContains(response, escape(EMPTY ITEM ERROR)) 


我 们 定义 了 一 个 辅助 方法 post_invalid_input， 这 样 就 不 用 在 分 拆 的 四 个 测试 中 重复 编写 
代码 了 。 
这 种 做 法 我 们 见 过 几 次 了 。 把 视图 测试 写 在 一 个 测试 方法 中 ， 编 写 一 连 串 的 断言 检 训 视图 
应 该 做 这 个 、 这 个 和 这 个 ， 然 后 应 该 返回 那个 一 一 我 们 经 和 常 觉得 这 么 做 更 合理 ， 但 把 单个 
测试 方法 分 解 为 多 个 方法 也 绝对 有 好 处 。 从 前 面 几 章 我 们 已 经 得 知 ， 如 果 以 后 修改 代码 时 
不 小 心 引 入 了 一 个 问题 ， 分 拆 的 测试 能 帮助 定位 真正 的 问题 所 在 。 辅 助 方法 则 是 降低 心理 
障碍 的 方式 之 一 。 
例如 ， 现 在 测试 结果 只 有 一 个 失败 ， 而 且 我 们 知道 是 由 哪个 测试 方法 导致 的 : 

FAIL: test for invalid input shows error on page 

(lists.tests.test views.ListViewTest) 


AssertionError: False is not true : Couldn't find 'You can&#39;t have an empty 
list item' in response 


现在 ， 试 试 能 否 使 用 ItenForm RHH 
























































写 视图 。 第 一 次 尝试 : 


tg 








lists/views.py 


def view list(request, list id): 
list = List.objects.get(id-list id) 
form = ItemForm() 
if request.method -- 'POST': 
form = ItemForm(data-request.POST) 
if form.is valid(): 
Item.objects.create(text-request.POST['text'], list-list ) 
return redirect(list ) 
return render(request, 'list.html', ['list': list , "form": form}) 








重 写 后 ， 单 元 测试 通过 了 : 


Ran 23 tests in 0.086s 





OK 


再 看 功能 测试 的 结果 如 何 : 


ERROR: test cannot add empty list items 
(functional tests.test list item validation.ItemValidationTest) 


Traceback (most recent call last): 
File "/.../superlists/functional tests/test list item validation.py", line 
15, in test cannot add empty list items 


Lss] 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: .has-error 


失败 。 


14.4. 意 想不到 的 好 处 : HTML5 自 带 的 客户 端 验证 


这 是 怎么 回 事 呢 ? 我 们 在 错误 所 处 位 置 之 前 加 上 time.sleep， 看 看 会 发 生 什 么 (如 果 愿 
意 ， 也 可 以 执行 manage.py runserver 命令 ， 自 己 动手 访问 网 站 ， 如 图 14-1 所 示 )。 


























To-Do lists x | 中 








, | © | localhost:8081 € ||Q Search *8 + 会 





Start a new To-Do list 


| Enter a to-do item | 





| Please fill out this field. | 

















14-1; HTML5 验证 失败 


看 起 来 输入 框 为 空 时 ， 浏 览 器 禁止 用 户 提交 表单 。 
这 是 因为 Django 为 那个 HTML 输入 框 添加 了 required 属性 。 (不 相信 ? 再 看 一 下 前 面 的 
as pO 输出 。) 这 是 HTMLS 的 新 特性 ， 浏 览 器 会 在 客户 端 做 些 验证 ， 输 入 无 效 时 禁止 用 
户 提交 表单 。 























LX 
Hr 


E 1: 这 是 Django 1.11 的 新 特性 。 
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tis Jf cU REDUX. : 


functional tests/test list item validation.py (ch111032) 





def test cannot add empty list items(self): 





# 伊 迪 丝 访问 首页 ， 不 小 心 提 交 了 一 个 空 待 办 事项 
# 输入 框 中 没 输 入 内 容 ， 她 就 按 下 了 回 车 键 
self.browser.get(self.live server url) 

self.get item input box().send keys(Keys.ENTER) 












































# 浏览 器 截获 了 请 求 

# 清单 页 面 不 会 加 载 

self.wait for(lambda: self.browser.find elements by css selector( 
"itid text:invalid' Q9 

» 


# 她 在 待 办 事项 中 输入 了 一 些 文字 

# 错误 消失 了 

self.get item input box().send keys('Buy milk') 

self.wait for(lambda: self.browser.find elements by css selector( 
"tid text:valid' 6 

















)) 


# 现在 能 提交 了 
self.get item input box().send keys(Keys.ENTER) 
self.wait for row in list table('1: Buy milk') 


# 她 有 点 儿 调 皮 ， 打 算 再 提交 一 个 空 待 办 事项 
self.get item input box().send keys(Keys.ENTER) 








# 浏览 器 这 次 也 不 会 放行 

self.wait for row in list table('1: Buy milk') 

self.wait for(lambda: self.browser.find elements by css selector( 
"itid text:invalid' 


) 


# 输入 一 些 文字 后 就 能 纠正 这 个 错误 

self.get item input box().send keys('Make tea') 

self.wait for(lambda: self.browser.find elements by css selector( 
"tid text:valid' 

» 

self.get item input box().send keys(Keys.ENTER) 

self.wait for row in list table('1: Buy milk') 

self.wait for row in list table('2: Make tea') 


@ 不 再 检查 我 们 自 定义 的 错误 消息 ， 而 是 通过 CSS 伪 选 择 符 invalid 检查 。 这 个 伪 选 








择 符 是 浏览 器 为 输入 无 效 内 容 的 HTML5 输入 框 添加 的 。 


@ 输入 有 效 的 内 容 时 ， 伪 选 
看 到 self.wait for 国 数 多 么 
现在 的 功能 测试 与 刚 开 始 时 





先 择 符 逆转 。 
有 用 、 多 么 灵活 了 吗 ? 
区 别 很 大 ， 我 相信 此 时 此 刻 你 有 很 多 疑问 。 先 别 急 


的 。 先 来 看 看 测试 是 否 又 能 通过 了 : 


\， 我 会 


说 明 





$ python manage.py test functional tests 
[54] 


Ran 4 tests in 12.154s 


OK 


14.5 ”值得 鼓励 


首先 ， 给 自己 一 个 大 大 的 肯定 : 我 们 刚刚 完成 了 这 个 小 型 应 用 中 的 一 项 重要 修改 一 一 那个 
输入 框 ， 以 及 它 的 name 和 id 属性 ， 对 应 用 正常 运行 至 关 重 要 。 我 们 修改 了 七 八 个 文件 ， 
完成 了 一 次 工作 量 很 大 的 重 构 。 如 果 没 有 测试 ， 做 这 么 复杂 的 重 构 我 一 定 会 担心 ， 其 至 有 
可 能 觉得 没 必 要 再 去 改动 可 以 使 用 的 代码 。 可 是 ， 我 们 有 一 套 完整 的 测试 组 件 ， 所 以 可 以 
深入 研究 、 整 理 代 码 ， 这 些 操作 都 很 安全 ， 因 为 我 们 知道 如 果 有 错误 ， 测 试 能 发 现 。 所 以 
我 们 会 不 断 重 构 、 整 理 和 维护 代码 ， 确 保 整个 应 用 的 代码 干净 整洁 ， 运 行 起 来 毫 无 障 但 、 
准确 无 误 ， 而 且 功能 完善 。 


。 去 除 视 因 中 验证 水 辑 早 的 重复 


现在 是 提交 的 绝 佳 时 刻 : 


$ git diff 
$ git commit -am "use form in all views, back to working state" 


14.6 ”这 难道 不 是 浪费 时 间 吗 


如 有 果 这 样 的 话 ， 我 们 自 定义 的 错误 消息 还 有 什么 用 呢 ? 我 们 在 HTML 模板 中 费 这 么 大 力气 
这 染 表 单 都 是 无 用 功 吗 ? 如 果 在 产生 错误 之 前 ， 浏 览 器 就 截获 了 请 求 ，Django 根本 无 法 把 
错误 呈现 到 用 户 面前 ， 功 能 测试 也 就 无 从 测试 。 

好 吧 ， 你 说 得 对 。 但 是 我 们 的 时 间 并 没有 浪费 ， 原 因 有 三 个 。 首 先 ， 客 户 端 验证 不 能 百 分 
百 阻止 无 效 输入 。 如 果 你 真 的 在 意 数据 完整 性 ， 就 必须 使 用 服务 器 端 验 证 ， 而 这 部 分 逻辑 
很 适合 封装 在 表单 中 。 

其 次 ， 不 是 所 有 浏览 器 ( 咳 ，Safari) 都 完全 支持 HTML5， 有 些 用 户 还 是 能 看 到 我 们 自 定 
义 的 消息 的 。 而 且 ， 如 果 我 们 打算 让 用 户 通过 AP 访问 数据 (参见 附录 FF)， 验 证 消息 也 
会 回 送 给 用 户 。 
此 外 ， 下 一 章 将 重用 这 里 的 验证 、 表 单 代 码 以 及 前 端 .has-error 类 ， 实 现 一 些 HTMLS ix 
有 的 高 级 验证 。 
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话说 回来 ， 就 算 没 有 这 些 理 由 ， 你 也 不 用 为 编程 时 走 错 路 了 而 责怪 自己 。 没 人 能 预见 未 
来 ,我们 的 目标 是 找 出 正确 的 解决 方案 ， 不惜“ 浪费 ”时 间 在 错误 的 方案 上 。 


-+H 一 o 
14.7 ”使 用 表单 自 市 的 save 方 法 
我 们 还 可 以 进一步 简化 视图 。 前 面 说 过 ， 表 单 可 以 把 数据 存 和 数据库。 我 们 遇 到 的 情况 并 
不 能 直接 保存 数据 ， 因 为 需要 知道 把 待 办 事项 保存 到 哪个 清单 中 ， 不 过 解决 起 来 也 不 难 


一 如 既往 ， 先 编写 测试 。 为 了 查 明 遇 到 的 问题 ， 先 看 一 下 如 果 直 接 调用 form.save() 会 发 
生 什么 : 




















LY 


























o 











lists/tests/test forms.py (ch111033) 


def test form save handles saving to a list(self): 
form = ItemForm(data-('text': 'do me'}) 
new item - form.save() 


Django 报错 了 ， 因 为 待 办 事项 必须 隶属 于 某 个 清单 


django.db.utils.IntegrityError: NOT NULL constraint failed: lists item.list id 


这 个 问题 的 解决 办 法 是 告诉 表单 的 save 方法 ， 应 该 把 待 办 事项 保存 到 哪个 清单 中 : 




















lists/tests/test forms.py 


from lists.models import Item, List 


[...] 


def test form save handles saving to a list(self): 
list = List.objects.create() 
form = ItemForm(data-('text': 'do me'}) 
new item - form.save(for list-list ) 
self.assertEqual(new item, Item.objects.first()) 
self.assertEqual(new item.text, 'do me') 
self.assertEqual(new item.list, list ) 


， 要 保证 待 办 事项 能 顺利 存 和 数据库， 而 且 各 个 属性 的 值 都 正确 : 


TypeError: save() got an unexpected keyword argument 'for list' 


可 以 定制 save 方法 ， 实 现 方式 如 下 : 








lists/forms.py (ch111035) 


def save(self, for list): 
self.instance.list - for list 
return super().save() 


表单 的 instance 属性 是 将 要 修改 或 创建 的 数据 库 对 象 。 我 也 是 在 撰写 本 章 时 才 知 道 这 种 
用 法 的 。 此 外 还 有 很 多 方法 ， 例 如 自己 手动 创建 数据 库 对 象 ， 或 者 调用 saveO 方法 时 指定 
参数 commit=False， 但 我 觉得 使 用 .instance 属性 最 简洁 。 下 一 章 还 会 介绍 一 种 方法 ， 让 
表单 知道 它 应 用 于 哪个 清单 。 
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Ran 24 tests in 0.086s 
OK 


最 后 ， 要 重 构 视 图 。 先 重 构 new_List: 





def new list(request): 

form = ItemForm(data-request.POST) 

if form.is valid(): 
list = List.objects.create() 
form.save(for list-list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', ["form": form)) 


然后 运行 测试 ， 确 保 都 能 通过 : 


Ran 24 tests in 0.086s 
OK 


接着 重 构 view list; 


def view list(request, list id): 
list = List.objects.get(id-list id) 
form = ItemForm() 
if request.method -- 'POST': 
form = ItemForm(data-request.POST) 
if form.is valid(): 
form.save(for list-list ) 
return redirect(list ) 


return render(request, 'list.html', ['list': list , "form": 


修改 之 后 ， 单 元 测试 仍 能 全 部 通过 : 


Ran 24 tests in 0.111s 
OK 


功能 测试 也 能 通过 : 


Ran 4 tests in 14.367s 
OK 


lists/views.py 


lists/views.py 


form}) 


KET! 现在 这 两 个 视图 更 像 是 “正常 的 ”Django 视图 了 : 从 用 户 的 请 求 中 读 取 数据 ， 结 
合 一 些 定制 的 逻辑 或 URL 中 的 信息 (list_id)， 然 后 把 数据 传 入 表单 进行 验证 ， 如 果 通 过 











验证 就 保存 数据 ， 最 后 重 定 向 或 者 泻 染 模板 。 











表单 和 验证 在 Django 以 及 常规 的 Web 编程 中 都 很 重要 ， 下 一 章 要 看 一 下 能 否 编写 稍微 复 





杂 的 表单 。 
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小 贴 士 
简化 视图 
如 果 发 现 视 图 很 复杂 ， 要 编写 很 多 测试 ， 这 时 候 就 应 该 考虑 是 否 能 把 逻辑 移 到 其 他 
地 方 。 可 以 移 到 表单 中 ， 就 像 本 章 中 的 做 法 一 样 ， 也 可 以 移 到 模型 类 的 自 定义 方 
法 中 。 如 果 应 用 本 身 就 很 复杂 ， 可 以 把 核心 业务 逻辑 移 到 Django 专属 的 文件 之 外 ， 
编写 单独 的 类 和 函数 。 
一 个 测试 只 测试 一 件 事 
如 果 一 个 测试 中 不 止 一 个 断言 ， 你 就 要 怀疑 这 么 写 是 否 合理 。 有 时 断言 之 间 联 系 紧 
客 ， 可 以 放 在 一 起 。 不 过 第 一 次 编写 测试 时 往往 部 会 测试 很 多 表现 ， 其 实 应 该 把 它 
们 分 成 多 个 测试 。 辅 助 函 数 有 助 于 简化 拆 分 后 的 测试 。 
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高 级 表单 





接 下 来 ， 你 将 看 到 表单 的 一 些 高 级 用 法 。 我 们 已 经 帮助 用 户 避 免 输入 空 待 办 事项 ， 接 下 来 
要 避免 用 户 输入 重复 的 待 办 事项 。 


本 章 将 进一步 介绍 Django 表单 验证 的 细节 。 如 果 你 已 经 完全 了 解 如 何 定制 Django 表单 
或 者 你 阅读 本 书 的 目的 是 学 习 TDD 而 不 是 Django， 那 就 可 以 跳 过 本 章 。 


如 果 你 还 想 接着 学 习 Django， 本 革 有 些 值 得 学 习 的 重要 知识 。 如 果 你 想 跳 过 本 章 也 可 以 ， 
不 过 一 定 要 快速 阅读 关于 开发 者 犯错 的 框 注 和 本 章 末 尾 对 视图 测试 的 总 结 。 


15.1 针对 重复 待 办 事项 的 功能 测试 


在 ItemValidationTest 类 中 再 添加 一 个 测试 方法 : 
































functional tests/test list item validation.py (ch131001) 





def test cannot add duplicate items(self): 
# 伊 迪 丝 访问 首页 ， 新 建 一 个 清单 
self.browser.get(self.live server url) 
self.get item input box().send keys('Buy wellies') 
self.get item input box().send keys(Keys.ENTER) 
self.wait for row in list table('1: Buy wellies') 





# 她 不 小 心 输入 了 一 个 重复 的 待 办 事项 
self.get item input box().send keys('Buy wellies') 
self.get item input box().send keys(Keys.ENTER) 








# 她 看 到 一 条 有 帮助 的 错误 消息 
self.wait for(lambda: self.assertEqual( 
self.browser.find element by css selector('.has-error').text, 
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"You've already got thi 


)) 


s in your list" 


为 什么 编写 两 个 测试 方法 ， 而 不 直接 在 原来 的 基础 上 扩展 ， 或 者 新 建 一 个 文件 和 类 ? 要 自 
己 判 断 该 怎么 做 。 这 两 种 方法 看 起 来 联系 紧密 ， 都 和 同一 个 输入 字段 的 验证 有 关 ， 所 以 放 








在 同一 个 文件 中 没 问题 。 另 一 方面 ， 
的 两 种 不 同 的 方法 是 可 行 的 : 
$ python manage.py test functio 
Ee] 


selenium. common .exceptions .NoSu 
element: .has-error 











Ran 2 tests in 9.613s 








这 两 种 方法 在 逻辑 上 互相 独立 ， 所 以 将 它们 设 为 不 同 


nal tests.test list item validation 


chElementException: Message: Unable to locate 





好 的 ， 这 两 个 测试 中 的 第 一 个 现在 可 以 通过 。 你 可 能 会 癌 :“ 有 没有 办 法 只 运行 那个 失败 


的 测试 ? ”确实 有 : 


$ python manage.py test functio 
test list item validation.ItemV 
[1 
selenium.common.exceptions.NoSu 
element: .has-error 


nal tests.V 
alidationTest.test cannot add duplicate items 


chElementException: Message: Unable to locate 


15.1.1 在 模型 层 禁 止 重复 
这 是 我 们 真正 要 做 的 事情 。 编 写 一 个 新 测试 ， 检 查 同一 个 清单 中 有 重复 的 待 办 事项 时 是 否 


hl 








抛 出 异常 ; 


def test duplicate items are in 
list = List.objects.create 
Item.objects.create(list-li 
with self.assertRaises(Vali 
item - Item(list-list , 
item.full clean() 


此 外 ， 还 要 再 添加 一 个 测试 ， 确 保 完 





lists/tests/test models.py (ch091028) 


valid(self): 

() 

st , text-'bla') 
dationError): 
text-'bla') 


整 性 约束 不 要 做 过 头 了 : 


lists/tests/test models.py (ch091029) 


def test CAN save same item to different lists(self): 


list1 = List.objects.create 
list2 = List.objects.create 
Item.objects.create(list-li 
item - Item(list-list2, tex 
item.full clean() # 不 该 殷 H 


O 

O 

sti, text-'bla') 
t-'bla') 

异常 








我 总 喜欢 在 检查 某 项 操作 不 该 抛 出 异常 的 测试 中 加 入 一 些 注释 ， 要 不 然 很 难看 出 在 测试 什么 。 


AssertionError: ValidationError 


如 果 想 故意 犯错 ， 可 以 这 么 做 : 








not raised 
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lists/models.py (ch091030) 


class Item(models.Model): 
text - models.TextField(default-'', unique-True) 
list = models.ForeignKey(List, default-None) 


这 么 做 可 以 确认 第 二 个 测试 确实 能 检测 到 这 个 问题 : 


Traceback (most recent call last): 
File "/.../superlists/lists/tests/test models.py", line 62, in 
test CAN save same item to different lists 
item.full clean() # 不 该 抛 出 异常 
[...] 
django.core.exceptions.ValidationError: {'text': ['Item with this Text already 
exists.']) 








何 时 测试 开发 者 犯 下 的 错误 
测试 时 要 判断 何 时 应 该 编写 测试 确认 我 们 没有 犯错 。 一 般 而 言 ， 做 决定 时 要 谨慎 。 


这 里 ， 编 写 测试 确认 无 法 把 重复 的 待 办 事项 存 入 同一 个 清单 。 目 前 ， 让 这 个 测试 通过 
最 简单 的 方法 ( 即 编 写 的 代码 量 最 少 ) 是 ， 让 表单 无 法 保存 任何 重复 的 待 办 事项 。 此 
时 就 要 编写 另 一 个 测试 ， 因 为 我 们 编写 的 代码 可 能 有 错 。 


但 是 ， 不 可 能 编写 测试 检查 所 有 可 能 出 错 的 方式 ”如果 有 一 个 函数 计算 两 数 之 和 ， 可 
以 编写 一 些 测试 : 


assert adder(1, 1) == 2 
assert adder(2, 1) == 3 


但 不 应 该 认为 实现 这 个 函数 时 故意 编写 了 有 违 常理 的 代码 : 


def adder(a, b): 
# 不 可 能 这 么 写 ! 
if a 2-3: 
return 666 
else: 
return a + b 


判断 时 你 要 相信 自己 不 会 故意 犯错 ， 只 会 不 小 心 犯错 。 











模型 和 ModelForn 一 样 ， 也 能 使 用 class Meta, E Meta 类 中 可 以 实现 一 个 约束 ， 要 求 清单 
中 的 待 办 事项 必须 是 唯一 的 。 也 就 是 说 ，text 和 tist 的 组 合 必须 是 唯一 的 : 





























lists/models.py (ch09103 I) 


class Item(models.Model): 
text = models.TextField(default-'') 
list = models.ForeignKey(List, default-None) 


Class Meta: 
unique together - ('list', 'text') 


此 时 ， 你 可 能 想 快 速 浏 览 一 志 Django 文档 中 对 模型 属性 Meta 的 说 明 。 
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15.1.2. BAN E: 查询 集合 排序 和 字符 串 表 示 形 式 
运行 测试 ， 会 看 到 一 个 意料 之 外 的 失败 ; 


FAIL: test saving and retrieving items 
(lists.tests.test models.ListAndItemModelsTest) 
Traceback (most recent call last): 

File "/.../superlists/lists/tests/test models.py", line 31, in 
test saving and retrieving items 

self.assertEqual(first saved item.text, 'The first (ever) list item') 

AssertionError: 'Item the second' !- 'The first (ever) list item' 
- Item the second 


E. 


根据 所 用 系统 和 SQLite 版 本 的 不 同 ， 你 可 能 看 不 到 这 个 错误 。 如 果 没 看 到 就 
直接 阅读 下 一 节 ， 代 码 和 测试 本 身 也 很 有 趣 。 





























JW RS IE 输出 一 些 信息 ， 以 便 调试 : 


lists/tests/test models.py 


first saved item = saved items[0] 

print(first saved item.text) 

second saved item - saved items[1] 

print(second saved item.text) 

self.assertEqual(first saved item.text, 'The first (ever) list item') 


然后 ， 看 到 的 测试 结果 如 下 : 


Trepa Item the second 
The first (ever) list item 


看 样子 唯一 性 约束 干扰 了 查询 〈 例 如 Item.objects.allO) 的 默认 排序 。 虽 然 现 在 仍 有 测 
试 失 败 ， 但 最 好 添加 一 个 新 测试 明确 测试 排序 : 





lists/tests/test models.py (ch091032) 


def test list ordering(self): 

listi = List.objects.create() 
item1 = Item.objects.create(list-listi, text-'ii1') 
item2 - Item.objects.create(list-listi, text-'item 2') 
item3 = Item.objects.create(list-listi, text='3') 
self.assertEqual( 

Item.objects.all(), 

[item1, item2, item3] 


) 
测试 的 结果 多 了 一 个 失败 ， 而 且 也 不 易 读 : 




















AssertionError: «QuerySet [«Item: Item object», «Item: Item object», «Item: 


Item object»]» !- [«Item: Item object», «Item: Item object», «Item: Item 
object»] 


我 们 的 对 象 需要 一 个 更 好 的 字符 串 表 示 形 式 。 下 面 再 添加 一 个 单元 测试 

















如 果 已 经 有 测试 失败 ， 还 要 再 添加 更 多 的 失败 测试 ， 通常 都 要 三 思 而 后 行 ， 
因为 这 么 做 会 让 测试 的 输出 变 得 更 复杂 ， 而 且 往 往 你 都 会 担心 :“ 还 能 回 到 


Ae TL 4. 


常 运行 的 状态 吗 ? ”这 里 ， 测 试 都 很 简单 ， 所 以 我 不 担忧 。 





























lists/tests/test models.py (ch131008) 
def test string representation(self): 
item = Item(text-'some text') 
self.assertEqual(str(item), 'some text') 


测试 的 结果 为 : 


AssertionError: 'Item object' != 'some text' 


连同 另外 两 个 失败 ， 现 在 开始 一 并 解决 : 








lists/models.py (ch091034) 
class Item(models.Model): 


[...] 


def str (self): 
return self.text 





在 Python 2.x 的 Django 版 本 中 ， 字 符 串 表示 形式 使 用 __unicode__ 方 法 定制 。 
和 很 多 字符 串 处 理 方式 一 样 ，Python 3 对 此 做 了 简化 。 参 见 文档 (https:// 
docs.djangoproject.com/en/1.11/topics/python3/#str-and-unicode-methods ) 。 











现在 只 剩 两 个 失败 测试 了 ， 而 且 排 序 测 试 的 失败 消息 更 易 读 了 : 
AssertionError: «QuerySet [«Item: 


: dd», «Item: item 2>, «Item: 3>]> !- [«Item: 
i1», «Item: item 2>, «Item: 3>] 


可 以 在 class Meta 中 解决 这 个 问题 : 


lists/models.py (ch091035) 


class Meta: 
ordering = ('id',) 
unique together - ('list', 'text') 


这 么 做 有 用 吗 ? 
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AssertionError: «QuerySet [«Item: i1», «Item: item 2», «Item: 3>]> !- [«Item: 
i1», «Item: item 2>, «Item: 3>] 


呢 ， 确 实 有 用 ， 从 测试 结果 中 可 以 看 到 ， 顺 序 是 一 样 的 ， 只 不 过 测试 没 分 清 。 甚 实 我 一 直 
会 遇 到 这 个 问题 ， 因 为 Django 中 的 查询 集合 不 能 和 列表 正确 比较 。 可 以 在 测试 中 把 查询 
集合 转换 成 列表 “解决 这 个 问题 














lists/tests/test models.py (ch091036) 


self.assertEqual( 
list(Item.objects.all()), 
[item1, item2, item3] 
) 
这 样 就 可 以 了 ， 整 个 测试 组 件 都 能 通过 : 


OK 


15.1.3 重 写 旧 模 型 测试 


虽然 元 长 的 模型 测试 无 意 间 帮 我 们 发 现 了 一 个 问题 ， 但 现在 要 重 写 模型 测试 。 重 写 的 过 
程 中 我 会 讲 得 很 详细 ， 因 为 借 此 机 会 要 介绍 Django ORM。 既 然 我 们 已 经 编写 了 专门 测试 
排序 的 测试 ， 现 在 就 可 以 使 用 一 些 较 短 的 测试 达到 相同 的 覆盖 度 。 删 除 test. saving and. 
retrieving_items， 换 成 : 




















lists/tests/test models.py (ch131010) 
class ListAndItemModelsTest(TestCase): 


def test default text(self): 
item - Item() 
self.assertEqual(item.text, '') 


def test item is related to list(self): 
list = List.objects.create() 
item - Item() 
item.list = list. 
item.save() 
self.assertIn(item, list .item set.all()) 


[...] 
这 公 改 绩 绩 有 余 。 初 始 化 一 个 全 新 的 模型 对 象 ， 检 查 属性 的 默认 值 ， 这 么 做 足以 确认 
models.py 中 是 否 正确 设 定 了 一 些 字段 。test_item_is_relLated_to_lList 其 实 是 双重 保险 ， 
确认 外 键 关 联 是 否 正常 。 
借 此 机 会 ， 还 要 把 这 个 文件 中 的 内 容 分 成 专门 针对 Iten 和 List 的 测试 (后 者 只 有 一 个 测 
试 方法 ， 即 test get absolute url); 












































注 1: 也 可 以 考虑 使 用 unittest 中 的 assertSequenceEquaL， 以 及 Django 测试 工具 中 的 assertQuerysetEqual。 
不 过 我 承认 ， 之 前 我 并 没 搞 清楚 怎么 使 用 assertQuerysetEqual。 




















lists/tests/test models.py (ch131011) 


class ItemModelTest(TestCase): 
def test default text(self): 
[25] 
class ListModelTest(TestCase): 


def test get absolute url(self): 
D] 


修改 之 后 代码 更 整洁 。 测 试 结果 如 下 : 
$ python manage.py test lists 


[ 
Ran 29 tests in 0.092s 





OK 


15.1.4 mne 显示 完整 性 错误 


在 继续 之 前 还 有 一 个 题 外 话 要 说 。 我 在 第 13 章 提 到 过 ,保存 数据 时 会 出 现 一 些 数据 完整 
性 错误 ， imm uc uc. 


执行 makemigrations 命令 试 试 ， 你 会 看 到 ，Django 除了 把 unique together 作为 应 用 层 
东 之 外 ， 还 想 把 它 加 到 数据 库 中 ; 


$ python manage.py makemigrations 
Migrations for 'lists': 
lists/migrations/0005 auto 20140414 2038.py 
- Change Meta options on item 
- Alter unique together for item (1 constraint(s)) 


现在 ， 修 改 检查 重复 待 办 事项 的 测试 ， 把 . full clean 改 成 .save: 














lists/tests/test models.py 


def test duplicate items are invalid(self): 
list = List.objects.create() 
Item.objects.create(list-list , text-'bla') 
with self.assertRaises(ValidationError): 
item - Item(list-list , text-'bla') 
# item.full clean() 
item.save() 


测试 的 结果 为 : 


ERROR: test duplicate items are invalid (lists.tests.test models.ItemModelTest) 
[-] 
return Database.Cursor.execute(self, query, params) 
sqlite3.IntegrityError: UNIQUE constraint failed: lists item.list id, 
lists item.text 
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[...] 
django.db.utils.IntegrityError: UNIQUE constraint failed: lists item.list id, 
lists item.text 


可 以 看 出 ， 错 误 是 由 SQLite 导致 的 ， 而 且 错 误 类 型 也 和 我 们 期 望 的 不 一 样 ， 我 们 想得到 的 


是 ValidationError， 实 际 却 是 IntegrityError。 


把 改动 改 回去 ， 让 测试 全 部 通过 





$ python manage.py test lists 
[55s] 

Ran 29 tests in 0.092s 

OK 





然后 提交 对 模型 层 的 修改 : 


$ git status # 会 看 到 改动 了 测试 和 模型 ， 还 有 一 个 新 迁移 文件 

# 我 们 给 新 迁移 文件 起 一 个 更 好 的 名 字 

$ mv lists/migrations/0005 auto* lists/migrations/0005 list item unique together.py 
$ git add lists 

$ git diff --staged 

$ git commit -am "Implement duplicate item validation at model layer" 


15.2 在 视图 层 试 验 待 办 事项 重复 验证 


运行 


了 功能 测试 ， 看 看 现在 我 们 进展 到 哪里 了 : 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: .has-error 


运行 功能 测试 时 浏览 器 窗口 一 内 而 过 , 你 可 能 没 看 到 网 站 现在 处 于 500 状态 之 中 。? 简单 的 
修改 视图 层 单元 测试 应 该 能 解决 这 个 问题 











lists/tests/test views.py (ch131014) 


class ListViewTest(TestCase): 


[...] 


def test for invalid input shows error on page(self): 


[cd 


def test duplicate item validation errors end up on lists page(self): 
listi = List.objects.create() 
item1 = Item.objects.create(list-listi, text-'textey') 
response - self.client.post( 
f'/lists/(listi.id)/', 
data-('text': 'textey') 


























注 2: 显示 一 个 服务 器 错误 ， 响 应 码 为 S00。 你 要 明白 这 些 术语 的 意思 。 
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expected error - escape("You've already got this in your list") 
self.assertContains(response, expected error) 
self.assertTemplateUsed(response, 'list.html') 
self.assertEqual(Item.objects.all().count(), 1) 


测试 结果 为 : 


django.db.utils.IntegrityError: UNIQUE constraint failed: lists item.list id, 
lists item.text 


我 们 不 想 让 测试 出 现 完整 性 错误 ! 理想 情况 下 ， 我 们 希望 在 尝试 保存 数据 之 前 调用 is. vatid 
时 ， 已 经 注意 到 有 重复 。 不 过 在 此 之 前 ， 表 单 必 须知 道 待 办 事项 属于 哪个 清单 。 


现在 暂时 为 这 个 测试 加 上 @skip 修饰 器 : 

















lists/tests/test views.py (ch131015) 


from unittest import skip 


[...] 


(skip 
def test duplicate item validation errors end up on lists page(self): 


15.3 处理 唯一 性 验证 的 复杂 表单 


新 建 请 单 的 表单 只 需 知道 一 件 事 ， 即 新 待 办 事项 的 文本 。 为 了 验证 清单 中 的 代办 事项 是 否 
唯一 ， 表 单 需要 知道 使 用 哪个 清单 以 及 待 办 事项 的 文本 。 就 像 前 面 我们 在 ItemForm 类 中 定 
X. save 方 法 一 样 ， 这 一 次 要 重 定义 表单 的 构造 方法 ， 让 它 知道 待 办 事项 属于 哪个 清单 。 


复制 前 一 个 表单 的 测试 ， 稍 微 做 些 修改 : 










































































lists/tests/test forms.py (ch131016) 


from lists.forms import ( 
DUPLICATE ITEM ERROR, EMPTY ITEM ERROR, 
ExistingLlistItemForm, ItemForm 

) 

[58] 


class ExistingLlistItemFormTest(TestCase): 


def test form renders item text input(self): 
list = List.objects.create() 
form = ExistinglistItemForm(for list-list ) 
self.assertIn('placeholder-"Enter a to-do item"', form.as p()) 


def test form validation for blank items(self): 
list = List.objects.create() 
form = ExistinglistItemForm(for list-list , data-['text': '']) 
self.assertFalse(form.is valid()) 
self.assertEqual(form.errors['text'], [EMPTY ITEM ERROR]) 
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def test form validation for duplicate items(self): 


list = List.objects.create() 
Item.objects.create(list-list , text-'no twins!') 
form = ExistingLlistItemForm(for list-list , data-('text': 'no twins!']) 


self.assertFalse(form.is valid()) 
self.assertEqual(form.errors['text'], [DUPLICATE ITEM ERROR]) 


要 历经 儿 次 TDD 循环 ， 最 后 才能 得 到 一 个 自 定义 的 构造 方法 。 这 个 构造 方法 会 忽略 for. ist 
参数 。 (我 不 会 写 出 全 部 过 程 ， 但 我 相信 你 会 做 完 的 ， 对 吗 ? 记 住 ， 测 试 山羊 能 看 到 一 切 。) 


lists/forms.py (ch091071) 


DUPLICATE ITEM ERROR = "You've already got this in your list" 
[...] 


class ExistingListItemForm(forms.models.ModelForm): 
def _ init (self, for_list, *args, **kwargs): 
super(). init (*args, **kwargs) 


现 阶段 的 错误 应 该 是 : 
ValueError: ModelForm has no model class specified. 


接 下 来 ， 让 这 个 表单 继承 现 有 的 表单 ， 看 测试 能 不 能 通过 : 








lists/forms.py (ch091072) 


class ExistingListItemForm(ItemForm): 
def _ init (self, for list, *args, **kwargs): 
super(). init (*args, **kwargs) 


能 通过 ， 现 在 只 剩 一 个 失败 测试 了 : 


FAIL: test form validation for duplicate items 
(lists.tests.test forms.ExistingListItemFormTest) 

self.assertFalse(form.is valid()) 
AssertionError: True is not false 


下 面 这 一 步 需要 了 解 一 点 Django 内 部 运作 机 制 ， 你 可 以 阅读 Django 文档 中 对 模型 验证 和 
表单 验证 的 介绍 。 

Django 在 表单 和 模型 中 都 会 调用 validate unique 方法 ， 借 助 instance 属性 在 表单 的 
validate unique 方法 中 调用 模型 的 validate_unique 方法 : 

















lists/forms.py 
from django.core.exceptions import ValidationError 
[ea] 


class ExistingListItemForm(ItemForm): 


def | init (self, for list, *args, **kwargs): 
super(). init (*args, **kwargs) 
self.instance.list - for list 





def validate unique(self): 
try: 
self.instance.validate unique() 
except ValidationError as e: 
e.error dict = ['text': [DUPLICATE ITEM ERROR]j 
self. update errors(e) 


这 段 代码 用 到 了 一 点 Django 魔法 ， 先 获取 验证 错误 ， 修 改 错误 消息 之 后 再 把 错误 传 回 
表单 。 
任务 完成 ， 做 个 简单 的 提交 : 


$ git diff 
$ git commit -a 


15.4 ”在 清单 视图 中 使 用 ExistingListItemForm 
现在 看 一 下 能 否 在 视图 中 使 用 这 个 表单 。 
出 掉 测试 方法 的 esktp 修饰 器 ， 同 时 使 用 前 一 节 创 建 的 常量 清理 测试 。 














L 






































lists/tests/test views.py (ch131049) 


from lists.forms import ( 
DUPLICATE ITEM ERROR, EMPTY ITEM ERROR, 
ExistinglistItemForm, ItemForm, 

) 

[s] 


def test duplicate item validation errors end up on lists page(self): 
[5.7 
expected error - escape(DUPLICATE ITEM ERROR) 


修改 之 后 完整 性 错误 又 出 现 了 : 


django.db.utils.IntegrityError: UNIQUE constraint failed: lists item.list id, 
lists item.text 


解决 方法 是 使 用 前 一 节 定 义 的 表单 类 。 在 此 之 前 ， 先 找到 检查 表单 类 的 测试 ， 然 后 按照 下 
面 的 方式 修改 : 








lists/tests/test views.py (ch131050) 


class ListViewTest(TestCase): 


[252] 


def test displays item form(self): 
list = List.objects.create() 
response = self.client.get(f'/lists/[list .id)/') 
self.assertIsInstance(response.context['form'], ExistingListItemForm) 
self.assertContains(response, 'name-"text"') 
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[...] 


def test for invalid input passes form to template(self): 
response - self.post invalid input() 
self.assertIsInstance(response.context['form'], ExistingLlistItemForm) 


修改 之 后 测试 的 结果 为 : 


AssertionError: «ItemForm bound-False, valid-False, fields-(text)» is not an 
instance of «class 'lists.forms.ExistingListItemForm'» 


那么 就 可 以 修改 视图 了 : 





lists/views.py (ch131051) 
from lists.forms import ExistinglistItemForm, ItemForm 
[Li] 
def view list(request, list id): 
list = List.objects.get(id-list id) 
form = ExistinglistItemForm(for list-list ) 
if request.method -- 'POST': 
form = ExistingListItemForm(for list-list , data-request.POST) 
if form.is valid(): 
form.save() 


[2] 
问题 几乎 都 解决 了 ， 但 又 出 现 了 一 个 意料 之 外 的 失败 : 





TypeError: save() missing 1 required positional argument: 'for list' 


不 再 需要 使 用 父 类 ItemForm 中 自 定义 的 save 方法 。 为 此 ， 先 编写 一 个 单元 测试 : 





lists/tests/test forms.py (ch131053) 
def test form save(self): 
list = List.objects.create() 


form = ExistinglistItemForm(for list-list , data-('text': 'hi']) 
new item - form.save() 


self.assertEqual(new item, Item.objects.all()[0]) 


可 以 让 表单 调用 祖父 类 中 的 save 方法 : 


lists/forms.py (ch131054) 
def save(self): 


return forms.models.ModelForm.save(self) 


个 人 观点 : 这 里 可 以 使 用 super， 但 是 有 参数 时 我 选择 不 用 ， 例 如 获取 祖父 
类 中 的 方法 。 我 觉得 使 用 Python 3 的 super) 方法 获取 直接 父 类 很 棒 ， 但 其 
他 用 途 太 容易 出 错 ， 而 且 写 出 的 代码 也 不 好 看 。 你 的 观点 可 能 与 我 不 同 。 




















高 定 ! 所 有 单元 测试 都 能 通过 : 








$ python manage.py test lists 


[57] 
Ran 34 tests in 0.082s 


OK 
针对 验证 的 功能 测试 也 能 通过 : 


$ python manage.py test functional tests.test list item validation 


[325] 


Ran 2 tests in 12.048s 





OK 
检查 的 最 后 一 步 一 一 运行 所 有 功能 测试 ， 
$ python manage.py test functional tests 


[...] 


Ran 5 tests in 19.048s 
OK 


太 棒 了 ， 最 后 还 要 提交 ， 再 回顾 一 下 之 前 所 学 的 内 容 。 


LL Ah x s ` 
15.5 小 结 : 目前 所 学 的 Django 测试 知识 
我 们 的 应 用 现在 看 起 来 更 像 是 “标准 的 ”Django 应 用 了 ， 它 实现 了 Django 常见 的 三 
E: 模型 、 表 单 和 视图 。 测 试 不 再 是 “ 试 水 式 ” 的 了 ， 代 码 也 更 像 是 实际 应 用 中 应 该 
有 的 样子 了 。 
每 个 关键 的 源码 文件 都 对 应 一 个 单元 测试 文件 ， 下 面 回 顾 一 下 内 容 最 多 (层级 也 最 高 ) 的 
那个 ， 即 test views (下 述 代码 清单 只 列 出 了 关键 测试 和 断言 ) 。 
































如 何 测试 视图 
lists/tests/test views.py 


class ListViewTest(TestCase): 

def test uses list template(self): 
response = self.client.get(f'/lists/(list .id)/') © 
self.assertTemplateUsed(response, 'list.html') 6 

def test passes correct list to template(self): 
self.assertEqual(response.context['list'], correct list) © 

def test displays item form(self): 
self.assertIsInstance(response.context['form'], ExistingListItemForm) OQ 
self.assertContains(response, 'name-"text"') 

def test displays only items for that list(self): 
self.assertContains(response, 'itemey 1') © 
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self.assertContains(response, 'itemey 2') © 
self.assertNotContains(response, 'other list item 1') 9 

def test can save a POST request to an existing list(self): 
self.assertEqual(Item.objects.count(), 1) Q 
self.assertEqual(new item.text, 'A new item for an existing list') Q 

def test POST redirects to list view(self): 
self.assertRedirects(response, f'/lists/(correct list.id)/') © 

def test for invalid input nothing saved to db(self): 
self.assertEqual(Item.objects.count(), 0) Q 

def test for invalid input renders list template(self): 
self.assertEqual(response.status code, 200) 
self.assertTemplateUsed(response, 'list.html') Q 

def test for invalid input passes form to template(self): 
self.assertIsInstance(response.context['form'], ExistingListItemForm) @ 

def test for invalid input shows error on page(self): 
self.assertContains(response, escape(EMPTY ITEM ERROR)) 9 

def test duplicate item validation errors end up on lists page(self): 
self.assertContains(response, expected error) 
self.assertTemplateUsed(response, 'list.html') 
self.assertEqual(Item.objects.all().count(), 1) 


使 用 Django 测试 客户 端 。 

检查 使 用 的 模板 。 然 后 在 模板 的 上 下 文中 检查 各 个 待 办 事项 。 

检查 每 个 对 象 都 是 希望 得 到 的 ， 或 者 查询 集合 中 包含 正确 的 待 办 事项 。 
检查 表单 使 用 正确 的 类 。 

检查 测试 模板 逻辑 : 每 个 for 和 if 语句 都 要 做 最 简单 的 测试 。 

对 于 处 理 POST 请 求 的 视图 ， 确 保有 效 和 无 效 两 种 情况 都 要 测试 。 
健全 性 检查 ( 可 选 )， 检 查 是 否 泻 染 指定 的 表单 ， 而 且 是 否 显示 错误 消息 。 


o o © © ©® © © 


























为 什么 要 测试 这 么 多 ?请 阅读 附录 B。 使 用 基于 类 的 视图 重 构 时 ， 这 些 测 试 能 保证 视图 仍 
然 可 以 正常 运行 。 
接 下 来 要 尝试 使 用 一 些 客户 端 代码 让 数据 验证 更 友好 。 我 想 你 知道 这 是 什么 意思 。 
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虽然 前 下 


试探 JavaScript 


“如 果 上 沉 想 让 我 们 享受 生活 ， 就 不 会 把 他 无 尽 的 痛苦 当 作 珍 贵 的 礼物 赠与 我 们 。” 














i 实现 的 验证 逻辑 很 好 ， 


John Calvin! 


但 当 用 户 开始 修正 问题 时 ， 让 待 办 事项 重复 的 错误 消息 








消失 ， 就 像 HTMLS 验证 错误 那样 ， 不 是 更 好 吗 ? 为 了 达到 这 个 效果 ， 需 要 使 用 少量 能 
JavaScript, 
每 天 使 用 Python 这 种 充满 乐趣 的 语言 编程 完全 把 我 们 宠 坏 了 。JavaScript 是 给 我 们 的 惩罚 。 
对 Web 开发 者 而 言 ， 这 是 绕 不 开 的 话题 。 接 下 来 要 十 分 谨慎 地 试探 如 何 使 用 JavaScript. 





16.1 

















我 假设 你 知道 基本 的 JavaScript 句法 。 如 果 你 还 没 读 过 《JavaScript 语言 精 
粹 》， 现 在 就 买 一 本 吧 ! 这 本 书 并 不 厚 。 








从 功能 测试 开始 


在 ItemValidationTest 类 中 添加 一 个 新 的 功能 测试 : 





functional tests/test list item validation.py (ch141001) 





def test error messages are cleared on input(self): 
# 伊 迪 丝 新 建 一 个 清单 ， 但 方法 不 当 ， 所 以 出 现 了 一 个 验证 错误 
self.browser.get(self.live server url) 
self.get item input box().send keys('Banter too thick') 
self.get item input box().send keys(Keys.ENTER) 











iE 1: 





Calvin and the Chipmunk 中 的 角 
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@ X 


e 


self.wait for row in list table('1: Banter too thick') 
self.get item input box().send keys('Banter too thick') 
self.get item input box().send keys(Keys.ENTER) 


self.wait for(lambda: self.assertTrue( © 
self.browser.find element by css selector('.has-error').is displayed() © 


) 


# 为 了 消除 错误 ， 她 开始 在 输入 框 中 输入 内 容 
self.get item input box().send keys('a') 




















# 看 到 错误 消息 消失 了 ， 她 很 高 兴 
self.wait for(lambda: self.assertFalse( 
self.browser.find element by css selector('.has-error').is displayed() 60 














)) 




















到 了 wait for, X.—JX1& X assertTrue, 





is displayed() 可 检查 元 素 是 否 可 见 。 不 能 只 靠 检查 元 素 是 否 存在 于 DOM 中 去 判断 ， 








K 





为 现在 要 开始 隐藏 元 素 了 。 

















无 疑 ， 这 个 测试 会 失败 。 但 在 继续 之 前 ， 要 应 用 “ 事 不 过 三 , 三 则 重 构 ”原则 ， 因 为 多 次 
使 用 CSS 查找 错误 消息 元 素 。 把 这 个 操作 移 到 一 个 辅助 函数 中 : 


然后 ， 在 test_list_item_validation.py 中 做 三 次 替换 ， 


functional tests/test list item validation.py (ch141002) 





class ItemValidationTest(FunctionalTest): 


def get error element(self): 
return self.browser.find element by css selector('.has-error') 


[...] 





我 喜欢 把 辅助 函数 放 在 使 用 它们 的 功能 测试 类 中 ， 仅 当 辅 助 函数 需要 在 别处 
使 用 时 才 放 在 基 类 中 ， 以 防止 基 类 太 腔 有 种 。 这 就 是 YAGNI 原则 。 














RE 


如: 


functional tests/test list item validation.py (ch141003) 





self.wait for(lambda: self.assertEqual( 
self.get error element().text, 
"You've already got this in your list" 


)) 


self.wait_for(lambda: self.assertTrue( 


self.get_error_element().is_displayed() 


)) 


Al 


self.wait_for(lambda: self.assertFalse( 
self.get_error_element().is_displayed() 
)) 
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得 到 了 一 个 预期 错误 : 


[...] 


self.get error element().is displayed() 


AssertionError: True is not false 


可 以 提交 这 些 代码 ， 作 为 对 功能 测试 的 首次 改动 。 


16.2 ”安装 一 个 基本 的 JavaScript 测 试 运行 程序 








$ python manage.py test functional tests.test list item validation 


f£ Python 和 Django 领域 中 选择 测试 工具 非常 简单 。 标 准 库 中 的 unittest 模块 完全 够 用 


了 ， 而 且 Django 测试 运行 程序 也 是 一 个 不 错 的 默认 选择 。 除 此 之 外 ， 还 有 一 些 替 代 工 


H. 


AN 





项 很 不 错 ， 已 能 满足 需求 。” 

















nose 很 受 欢迎 ，Green 是 新 推出 的 ， 我 个 人 对 pytest 的 印象 比较 识 刻 。 不 过 默认 选 





在 JavaScript 领域 ， 情 况 就 不 一 样 了 。 我 们 在 工作 中 使 用 YUI， 但 我 觉得 我 应 该 走出 去 
看 看 有 没有 其 他 新 推出 的 工具 。 我 被 如 此 多 的 选项 淹没 了 


jsUnit, Qunit, Mocha, 


Chutzpah, Karma, Testacular, Jasmine 等 。 而 且 还 不 仅 限于 此 : 选中 其 中 一 个 工具 后 ( 例 
































如 Mocha ) ， 我 还 得 选择 一 个 断言 框架 和 报告 程序 ， 或 许 还 要 选择 一 个 模拟 技术 库 一 一 永 
远 没 有 终点 。 

最 终 ， 我 决定 我 们 应 该 使 用 QUnit， 因 为 它 简 单 ， 跟 Python 单元 测试 很 像 ， 而 且 能 很 好 地 
和 jQuery 配合 使 用 。 

在 lists/static 中 新 建 一 个 目录 ， 将 其 命名 为 tests， 把 QUnit JavaScript 和 CSS 两 个 文件 下 载 





QUnit 的 HTML 样板 文件 内 容 如 下 ， 其 中 包含 一 个 冒 烟 测试 : 


到 该 目录 。 我 们 还 要 在 该 目录 中 放 入 一 个 tests.html 文件 : 


$ tree lists/static/tests/ 
lists/static/tests/ 

I— qunit-2.0.1.css 

I— qunit-2.0.1.js 

L— tests.html 




















<!DOCTYPE html» 
<html> 
<head> 
<meta charset="utf-8"> 
<meta name="viewport" content="width=device-width"> 
<title>Javascript tests</title> 
<link rel="stylesheet" href="qunit-2.0.1.css"> 
</head> 
<body> 
<div id="qunit"></div> 
<div id="qunit-fixture"></div> 








注 2: 无 可 否认 ， 一 旦 开始 找 Python BDD 工具 ， 情 况 会 稍微 复杂 一 些 。 
注 3: 纯粹 是 因为 Mocha 提供 了 NyanCat 测试 运行 程序 。 
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«script src-"qunit-2.0.1.js"»«/script» 
«script» 


QUnit.test("smoke test", function (assert) { 
assert.equal(1, 1, "Maths works!"); 


js 


</script> 
</body> 
</html> 
仔细 分 析 这 个 文件 时 ， 要 注意 儿 个 重要 的 问题 : 使 用 第 一 个 <script> 标签 引入 qunit-2.0.1, 
然后 在 第 二 个 <script> 标签 中 编 写 测试 的 主体 。 


如 果 在 Web 浏览 器 中 打开 这 个 文件 (不 用 运行 开发 服务 器 ， 在 硬盘 中 找到 这 个 文件 即 可 )， 
会 看 到 类 似 图 16-1 所 示 的 页 面 。 























v Javascript tests - Mozilla Firefox x 





File Edit View History Bookmarks Tools Help 


j v Javascript tests xc 











(€ ) © | file///home/harry/Dropbox/Book/source/chap: e |a Search | *à] & » 三 


Javascript tests 


C] Hide passed tests C Check for Globals 回 No try-catch 








Module: All modules "| 


Filter: | Go 











QUnit 2.0.1; Mozilla/5.0 (X11; Linux x86 64; rv:49.0) Gecko/20100101 Firefox/49.0 





Tests completed in 7 milliseconds. 
1 assertions of 1 passed, 0 failed. 


1. smoke test (1) Oms 











16-1: QUnit 的 基本 界面 
查看 测试 代码 会 发 现 ， 和 我 们 目前 编写 的 Python 测试 有 很 多 相似 之 处 : 


QUnit.test("smoke test", function (assert) { © 
assert.equal(1, 1, "Maths works!"); 6 


FIs 

@  QUnit.test KGE Y. — 4 WTXUH H, Æ AJLÆL Python 中 的 def test_something(self)。 
test 函数 的 第 一 个 参数 是 测试 名 ， 第 二 个 参数 是 一 个 国 数 ， 定 义 这 个 测试 的 主体 。 

@  assert.equal 函数 是 一 个 断言 ， 和 assertEqual 非常 像 ， 比 较 两 个 参数 的 值 。 不 过 ， 和 

在 Python 中 不 同 ， 不 管 失败 还 是 通过 都 会 显示 消息 ， 所 以 消息 应 该 使 用 肯定 式 而 不 是 
否定 式 。 

为 什么 不 修改 这 些 参数 ， 故 意 让 测试 失败 ， 看 看 效果 如 何 呢 ? 








16.3 ”使 用 jQuery 和 <div> 固 件 元 素 


下 面 来 摸索 一 下 这 个 测试 框架 能 做 什么 ， 并 借 此 开始 使 用 一 些 jQuery (不 可 或 缺 的 库 ， 为 
操纵 DOM TE BEI DU Vs d CER API) 。 











如 果 你 从 未 用 过 jQuery， 在 行文 的 过 程 中 我 会 尝试 解说 ， 以 防 你 完全 不 懂 。 这 
不 是 jQuery 教程 ， 所 以 在 阅读 本 章 的 过 程 中 最 好 抽出 一 两 个 小 时 研究 jQuery。 

















从 jquery.com 下 载 新 版 jQuery， 保存 到 lists/static 文件 夹 中 。 


下 面 在 测试 文件 中 使 用 jQuery， 并 添加 儿 个 HTML 元 素 。 先 试 着 显示 和 隐藏 元 素 ， 并 编写 
几 个 断言 ， 检 查 元 素 的 可 见 性 : 








lists/static/tests/tests.html 
«div idz"qunit-fixture"2«/div» 
«form ©@ 
«input name-"text" /> 


«div class-"has-error"»Error text«/div» 
</form> 


<script srcz"../jquery-3.1.1.min.js"»«/script» 6 
«script src-"qunit-2.0.1.js"»«/script» 


«script» 


QUnit.test("smoke test", function (assert) { 
assert.equal(S('.has-error').is(':visible'), true); ©@@ 
$('.has-error').hide(); © 
assert.equal($('.has-error').is(':visible'), false); © 


35 

</script> 
@ <fornm> 及 其 中 的 内 容 放 在 那儿 是 为 了 表示 真实 的 清单 页 面 中 的 内 容 。 
@ HZ jQuery. 


© jQuery 魔法 从 这 里 开始 ! $ 是 jQuery 的 瑞士 军刀 ， 用 来 查找 DOM 中 的 内 容 。$ 的 第 
一 个 参数 是 CSS 选择 符 ， 要 查找 类 为 “has-error” 的 所 有 元 素 。 查 找 得 到 的 结果 是 一 
个 对 象 ， 表 示 一 个 或 多 个 DOM 元 素 。 然 后 ， 可 以 在 这 个 对 象 上 使 用 很 多 有 用 的 方法 
处 理 或 者 查看 这 些 元 素 。 


@ 其 中 一 个 方法 是 .is， 它 的 作用 是 指出 某 个 元 素 的 表现 是 否 和 指定 的 CSS 属性 匹配 。 
这 里 使 用 visible 检查 元 素 是 否 显示 出 来 。 

© ”使 用 jQuery 提供 的 .hide() 方法 隐藏 这 个 «div» 元 素 。 其 实 ， 这 个 方法 是 在 元 素 上 动 
AE style="display: none" 属性 。 
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@ 最后， 使 用 第 二 个 assert.equal 断言 检查 隐藏 是 否 成 功 。 
刷新 浏览 器 后 应 该 会 看 到 所 有 测试 都 通过 了 。 
在 浏览 器 中 期 望 QUnit 得 到 的 结果 如 下 : 


2 assertions of 2 passed, 0 failed. 
1. smoke test (2) 


下 面 要 介绍 如 何 使 用 固件 (fixture), HEA BMR: 





= 














lists/static/tests/tests.html 
<script> 


QUnit.test("smoke test", function (assert) { 
assert.equal($('.has-error').is(':visible'), true); 
$('.has-error').hide(); 
assert.equal($('.has-error').is(':visible'), false); 

95 

QUnit.test("smoke test 2", function (assert) { 
assert.equal($('.has-error').is(':visible'), true); 
$('.has-error').hide(); 
assert.equal($('.has-error').is(':visible'), false); 


95 
</script> 


其 中 一 个 测试 失败 了 ， 有 点 儿 出 乎 预料 ， 如 图 16-2 所 示 。 














8$ - n X Javascript tests - Chromium 


L3] * Javascript tests x X 





« ei file;///home/harry/Dropbox/book/source/chapter. 1 O/superlists/lists/static/tests/tests.html X 


Javascript tests 





LJ Hide passed tests L Check for Globals D No try-catch 
Mozilla/5.0 (X11; Linux x86 64) AppleWebKit/537.36 (KHTML, like Gecko) Ubuntu Chromium/28.0.1500.71 Chrome!28.0.1500.71 Safari/537.36 





Tests completed in 24 milliseconds. 
3 assertions of 4 passed, 1 failed. 


1. smoke test (0, 2, 2) 
Rerun 
1. failed 


Expected: true 
Result: false 


Diff: true false 


Source: at Object.«anonymous» 
(file:///home/harry/Dropbox/book/source/chapter 10/superlists/lists/static/tests/tests.html:27:5) 


2. okay 























图 162. 两 个 测试 中 有 一 个 失败 了 


测试 失败 的 原因 是 ， 第 一 个 测试 把 显示 错误 消息 的 div 元 素 隐 藏 了 ， 所 以 运行 第 二 个 调试 
时 ， 一 开始 这 个 元 素 就 是 隐藏 的 。 





QUnit 中 的 测试 不 会 按照 既定 的 顺序 运行 ， 所 以 不 要 觉得 第 一 个 测试 一 定 会 
在 第 二 个 测试 之 前 运行 。 多 刷新 儿 次 试 坛 ， 你 会 发 现 失 败 的 测试 有 变化 。 





我 们 需要 一 种 方法 在 测试 之 间 执 行 清理 工作 ， 有 点 儿 类 似 于 setup 和 tearDown， 或 者 像 
Django 测试 运行 程序 一 样 ， 运 行 完 每 个 测试 后 还 原 数 据 库 。id 为 qunit-fixture 的 «div» 
元 素 就 是 我 们 正在 寻找 的 方法 。 把 表单 移 到 这 个 元 素 中 : 


lists/static/tests/tests.html 


«div id-"qunit"»«/div» 
«div id-"qunit-fixture"» 
«form» 
«input name-"text" /> 
«div class-"has-error"»5Error text«/div» 
</form> 
</div> 


<script src="../jquery-3.1.1.min.js"></script> 


你 可 能 已 经 猜 到 了 ， 每 次 运行 测试 前 ，jQuery 都 会 还 原 这 个 固件 元 素 中 的 内 容 。 因 此 ， 两 
个 测试 都 能 通过 了 : 





4 assertions of 4 passed, 0 failed. 
1. smoke test (2) 
2. smoke test 2 (2) 


16.4 为 想 要 实现 的 功能 编写 JavaScript 单 元 测试 


现在 我 们 已 经 熟悉 这 个 JavaScript 测试 工具 了 ， 所 以 可 以 只 留 下 一 个 测试 ， 开 始 编写 真正 
的 测试 代码 了 : 


lists/static/tests/tests.html 


«script» 
QUnit.test("errors should be hidden on keypress", function (assert) { 
$('input[name-"text"]').trigger('keypress'); © 


assert.equal($('.has-error').is(':visible'), false); 


DE 
</script> 
@ jQuery 提供 的 trigger 方法 主要 用 于 测试 ， 作 用 是 在 指定 的 元 素 上 触发 一 个 


JavaScript DOM 事件 。 这 里 使 用 的 是 keypress 事件 ， 当 用 户 在 指定 的 输入 框 中 输入 内 
容 时 ， 神 览 器 就 会 触发 这 个 事件 。 
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这 里 jQuery 隐藏 了 很 多 复杂 的 细节 。 不 同 浏览 器 之 间 处 理事 件 的 方式 大 不 一 
样 ， 详 情 请 访问 Quirksmode.org。jQuery 之 所 以 这 么 受 欢 迎 就 是 因为 它 消除 
TREFH, 





























这 个 测试 的 结果 为 : 


0 assertions of 1 passed, 1 failed. 
1. errors should be hidden on keypress (1, 0, 1) 
1. failed 
Expected: false 
Result: true 


假设 我 们 想 把 代码 放 在 单独 的 JavaScript 文件 中 ， 命 名 为 list.js: 





lists/static/tests/tests.html 


«script src="../jquery-3.1.1.min.js"></script> 
«script src="../list.js"></script> 
<script src="qunit-2.0.1.js"></script> 


<script> 


[...] 
若 想 让 这 个 测试 通过 ， 所 需 的 最 简 代 码 如 下 所 示 : 


lists/static/list.js 
$('.has-error').hide(); 


确实 通过 了 : 


1 assertions of 1 passed, 0 failed. 
1. errors should be hidden on keypress (1) 


但 显然 还 有 个 问题 ， 最 好 再 添加 一 个 测试 : 

















lists/static/tests/tests.html 


QUnit.test("errors should be hidden on keypress", function (assert) { 
S$('input[name-2"text"]').trigger('keypress'); 
assert.equal($('.has-error').is(':visible'), false); 


); 


QUnit.test('errors aren't hidden if there is no keypress", function (assert) { 
assert.equal($('.has-error').is(':visible'), true); 


); 
得 到 一 个 预期 的 失败 : 


1 assertions of 2 passed, 1 failed. 
1. errors should be hidden on keypress (1) 
2. errors aren't hidden if there is no keypress (1, 0, 1) 
1. failed 
Expected: true 
Result: false 





然后 ， 可 以 使 用 一 种 更 真实 的 实现 方式 : 





lists/static/list.js 


S$('input[name-"text"]').on('keypress', function (0 (. © 
$('.has-error').hide(); 
IDE 


0 ”这 行 代 码 的 意思 是 : 查找 所 有 name 属性 为 “text” 的 input 元素 ， 然 后 在 找到 的 每 个 
元 素 上 附属 一 个 事件 监听 器 ， 作 用 在 keypress 事件 上 上。 事件 监听 器 是 那个 行 间 函数 ， 
其 作用 是 隐藏 类 为 .has-error 的 所 有 元 素 。 


这 样 能 让 测试 通过 吗 ? 不 能 。 


1 assertions of 2 passed, 1 failed. 
1. errors should be hidden on keypress (1, 0, 1) 
1. failed 
Expected: false 
Result: true 




















EPA 


2. errors aren't hidden if there is no keypress (1) 


可 恶 ! 这 是 为 什么 呢 ? 


16.5 固件、 执行 顺序 和 全 局 状态 : JavaScript 
测试 的 重大 挑战 


一 般 来 说 ，JavaScript 的 一 大 难点 ， 尤 其 对 测试 而 言 ， 就 是 理解 代码 的 执行 顺序 ( 何 时 发 
生 什么 )。 我 们 想 知道 listjs 中 的 代码 何 时 运行 ， 每 个 测试 何 时 运行 ， 我 们 还 想 知 道 代 码 的 
运行 对 全 局 状态 (网 页 的 DOM) 有 何 影 响 ， 以 及 每 次 测试 后 是 如 何 清理 固件 的 。 


16.5.1 使 用 console.1log 打 印 调试 信息 
下 面 在 测试 中 添加 几 个 console.log， 打 印 调试 信息 : 
































7 











lists/static/tests/tests.html 


<script> 
console.log('qunit tests start'); 


QUnit.test("'errors should be hidden on keypress", function (assert) { 
console.log('in test 1'); 
$('input[name-"text"]').trigger( 'keypress'); 
assert.equal($('.has-error').is(':visible'), false); 


T; 


QUnit.test("errors aren't hidden if there is no keypress", function (assert) { 
console.log('in test 2'); 
assert.equal($('.has-error').is(':visible'), true); 

IDE 


</script> 
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然后 在 JavaScript 代码 中 也 这 样 做 : 





lists/static/list.js (ch141015) 


S$('input[name-"text"]').on('keypress', function () ( 
console.log('in keypress handler'); 
$('.has-error').hide(); 

5 

console.log('list.js loaded'); 


运行 测试 ， 打 开 浏 览 器 的 调试 控制 台 (通常 可 按 Ctrl-Shift-I 组 合 键 )， 你 应 该 会 看 到 类 似 


图 16-3 所 示 的 输出 。 





X Javascript tests - Mozilla Firefox x 











& © |file///home/harry/Dropbox/Book/source/chapter..14/su c | [Q »hantomis capture > Y & O & AOO 三 





f^ fà DippingOur.. [99 QUnit 2x.. | [2] GUnit BE TweetDe.. (€ Downloa... | XJavascri. x | DippingOur.. | 十 





Javascript tests 


CJ Hide passed tests CJ Check for Globals 器 No try-catch Module: All modules Y | 











Filter: | 





QUnit 2.0.1; Mozilla/5.0 (X11; Linux x86_64; rv:49.0) Gecko/20100101 Firefox/49.0 


Tests completed in 23 milliseconds. 
1 assertions of 2 passed, 1 failed. 


Rerun 


1. failed 
Expected: false 
Result: true 


Source: @file:///home/harry/Dropbox/Book/source/chapter_14/superlists/lists/static/tests/tests.html:28:3 























2. errors not be hidden unless there is a keypress (1) ems 
UL | CQ Inspector © Debugger () Style Edi.. © Performa... 三 Network ] Ej B &€umesx 
Ü € Net ~ 9 CSS ~ 9 JS ~ eSecuriy ~ 9Logging ~ 9Server ~ Q Filter output 

list.js loaded list.js:5:1 
qunit tests start tests.html:23:1 
in test 1 tests.html:26:3 
in test 2 tests.html:32:3 


> 











图 16-3. 在 QUnit MEHEA console. log 输出 的 调试 信息 


我 们 看 到 了 什么 ? 

。 listjs 先 被 加 载 ， 因 此 事件 监听 器 应 该 依附 到 输入 元 素 上 了 。 

。 然后 加 载 QUnit 测试 文件 。 

。 最 后 运行 各 个 测试 。 

但 仔细 一 想 ， 每 个 测试 都 会 “还 原 ” 国 件 div， 也 就 是 销毁 输入 元 素 后 再 重建 。 因 此 ， 
次 运行 测试 时 ，list.js 看 到 并 依附 事件 监听 器 的 输入 元 素 都 是 全 新 的 。 














16.5.2 ”使 用 初始 化 函数 精确 控制 执行 时 间 

我 们 需要 进一步 掌控 JavaScript 的 执行 顺序 ， 而 不 是 依赖 <script> 标签 加 载 并 运行 listjs 
中 的 代码 。 为 此 ， 常 见 的 做 法 是 定义 “初始 化 ”函数 ， 在 测试 (以 及 真实 的 场景 ) 中 需要 
的 地 方 调用 : 





lists/static/list.js 


var initialize - function () ( 
console.log('initialize called'); 
$('input[name-"text"]').on('keypress', function () { 
console.log('in keypress handler'); 
$('.has-error').hide(); 
35 
IE 
console.log('list.js loaded'); 


然后 在 测试 文件 中 的 每 个 测试 中 调用 initialize; 





lists/static/tests/tests.html (ch141017) 


QUnit.test("'errors should be hidden on keypress", function (assert) { 
console.log('in test 1'); 
initialize(); 
$('input[name-"text"]').trigger('keypress'); 
assert.equal($('.has-error').is(':visible'), false); 


F); 


QUnit.test("errors aren't hidden if there is no keypress", function (assert) { 
console.log('in test 2'); 
initialize(); 
assert.equal($('.has-error').is(':visible'), true); 


DE 
现在 ， 测 试 能 通过 ， 而 且 调试 输出 更 合理 了 : 
2 assertions of 2 passed, 0 failed. 


1. errors should be hidden on keypress (1) 
2. errors aren't hidden if there is no keypress (1) 





list.js loaded 
qunit tests start 
in test 1 
initialize called 
in keypress handler 
in test 2 
initialize called 


太 棒 了 ! 下 面 把 console.log 删 掉 : 


lists/static/list.js 


var initialize - function () ( 
$('input[name-"text"]').on('keypress', function () { 

$('.has-error').hide(); 

35 

E 
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把 测试 中 的 也 删 掉 : 
lists/static/tests/tests.html 


QUnit.test("errors should be hidden on keypress", function (assert) { 
initialize(); 
$('input[name-2"text"]').trigger( keypress'); 
assert.equal($('.has-error').is(':visible'), false); 

DE 

QUnit.test("errors aren't hidden if there is no keypress", function (assert) { 
initialize(); 
assert.equal($('.has-error').is(':visible'), true); 

95 

关键 时 刻 到 了 。 现 在 引入 jQuery 和 我 们 的 脚本 ， 在 真实 的 页 面 中 调用 初始 化 函数 : 


lists/templates/base.html (ch141020) 








</div> 
<script src="/static/jquery-3.1.1.min.js"></script> 
<script src="/static/list.js"></script> 


<script> 
initialize(); 
</script> 


</body> 
</html> 


习惯 做 法 是 在 HTML 的 body 元 素 末 尾 引 入 脚本 ， 这样 的 话 ， 用 户 无 须 等 到 
所 有 JavaScript 都 加 载 完 就 能 看 到 页 面 中 的 内 容 。 此 外 ， 还 能 保证 运行 脚本 
前 加 载 了 大 部 分 DOM, 


然后 运行 功能 测试 : 
$ python manage.py test functional tests.test list item validation.V 


ItemValidationTest.test error messages are cleared on input 


[x] 
Ran 1 test in 3.023s 
OK 


太 棒 了 ! 做 次 提交 


$ git add lists/static 
$ git commit -m "add jquery, qunit tests, list.js with keypress listeners" 


16.6 经验 做 法 : onload 样 板 代 码 和 命名 空间 


哦 ， 还 有 一 件 事 。initialize 这 个 国 数 名 称 太 普通 了 ， 如 果 引 入 的 某 个 第 三 方 JavaScript 
工具 也 有 名 为 initiatLize 的 函数 呢 ?” 下 面 为 其 添加 别人 不 太 可 能 使 用 的 “命名 空间 ”: 
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lists/static/list.js 


window.Superlists = {}; © 

window. Super lists.initialize = function () { @ 

$('input[name="text"]').on('keypress', function () { 
$('.has-error').hide(); 

35 

IE 


声明 一 个 对 象 ， 作 为 “window ”全 局 对 象 的 属性 ， 为 其 起 一 个 别人 不 太 可 能 使 用 
的 名 称 。 


然后 把 initialize 国 数 设 为 命名 空间 中 那个 对 象 的 属 


DE 


E. 








EE JavaScript 中 处 理 命名 空间 ， 还 有 很 多 更 取 巧 的 方式 ， 不 过 都 大 复杂 ， 
而 且 我 也 不 是 专家 ， 无 法 一 一 说 明 。 如 果 想 深入 学 习 ， 请 搜索 require.js 
这 似乎 已 经 成 为 了 标准 做 法 ， 至 少 在 当下 是 这 样 。 














lists/static/tests/tests.html 


«script» 

QUnit.test("errors should be hidden on keypress", function (assert) { 
window.Superlists.initialize(); 
$('input[name-"text"]').trigger('keypress'); 
assert.equal($('.has-error').is(':visible'), false); 


}); 


QUnit.test("errors aren't hidden if there is no keypress", function (assert) { 
window.Superlists.initialize(); 
assert.equal($('.has-error').is(':visible'), true); 

35 


</script> 


最 后 ， 如 果 JavaScript 需要 和 DOM 交互 ， 最 好 把 相应 的 代码 包含 在 onload 样板 代码 中 ， 
确保 在 执行 脚本 之 前 完全 加 载 了 页 面 。 目 前 的 做 法 也 能 正常 运行 ， 因 为 <script> 标签 在 页 
面 底部 ， 但 不 能 依赖 这 种 方式 。 


jQuery 提供 的 onload 样板 代码 非常 简洁 : 

















lists/templates/base.html 
<script> 
$(document).ready(function () f 
window.Superlists.initialize(); 


DE 


</script> 


更 多 信息 请 阅读 jQuery .ready() 的 文档 。 
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16.7 _ JavaScript 测试 在 TDD 循 环 中 的 位 置 


你 可 能 想 知道 JavaScript 测试 在 双重 TDD 循环 中 处 于 什么 位 置 。 答 案 是 ，JavaScript 测试 
和 Python 单元 测试 扮演 的 角色 完全 相同 。 

(D 编写 一 个 功能 测试 ， 看 着 它 失败 。 

(2) 判断 接 下 来 需要 哪 种 代码 ，Python 还 是 JavaScript ? 

(3) 使 用 选中 的 语言 编写 单元 测试 ， 看 着 它 失败 。 

(4) 使 用 选中 的 语言 编写 一 些 代 码 ， 让 测试 通过 。 

(5 重复 上 述 步 又 。 





想 多 练习 使 用 JavaScript 吗 ? 当 用 户 在 输入 框 内 点 击 或 者 输入 内 容 时 ， 看 看 
你 能 否 隐 藏 错误 消息 。 实 现 的 过 程 中 应 该 还 要 编写 功能 测试 。 

















我 们 几乎 可 以 进入 第 三 部 分 了 ， 但 在 此 之 前 还 有 最 后 一 步 : 把 修改 后 的 新 代码 部 署 到 服务 
器 中 。 别 忘 了 最 后 再 提交 一 次 (包含 base.html) | 


16.8 一些 缺憾 


本 章 的 目的 是 介绍 JavaScript 测试 基础 知识 ， 并 说 明 JavaScript 测试 在 TDD 循环 中 的 位 置 。 
下 面 几 点 可 做 深入 研究 。 


。 目前 的 测试 只 检查 JavaScript 能 否 在 一 个 页 面 中 使 用 。JavaScript 之 所 以 能 使 用 ， 是 因为 

在 base.html 中 引入 了 JavaScript 文件 。 如 果 只 在 home.html 中 引入 JavaScript 文件 ， 测 
试 也 能 通过 。 你 可 以 选择 在 哪个 文件 中 引入 ， 但 也 可 以 再 编写 一 个 测试 。 

。 编写 JavaScript 时 ， 应 该 尽量 利用 编辑 器 提供 的 协助 ， 避 免 常 见 的 问题 。 试 一 下 句法 / 
错误 检查 工具 (linter) ， 例 如 jslint 和 jshint。 

* QUnit 希望 你 在 真正 的 Web 浏览 器 中 “运行 ”测试 ， 这 样 有 利于 创建 与 网 站 的 真实 内 
容 匹 配 的 HTML 固件 ， 供 测试 使 用 。 但 是 ，JavaScript 测试 也 能 在 命令 行 中 运行 。 第 24 
章 有 个 例子 。 

。 前 端 开发 圈 目 前 流行 angular.js 和 React 这 样 的 MVC 框架 。 这 些 框架 的 教程 大 都 使 用 一 
个 RSpec 式 断 言 库 ， 名 为 Jasmine。 如 果 你 想 使 用 MVC 框架 ,使 用 Jasmine kk QUnit 更 
方便 。 


本 书后 面 还 会 涉及 JavaScript。 如 有 果 你 有 兴趣 ， 可 以 翻阅 附录 了 的 内 容 。 
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JavaScript 测试 笔记 
Selenium 最 大 的 优势 之 一 是 可 以 测试 JavaScript 是 否 真 的 能 使 用 ， 就 像 测试 Python 
代码 一 样 。 
JavaScript 测试 运行 库 有 很 多 ，QUnit 和 jQuery 联系 紧密 ， 这 是 我 选择 使 用 它 的 主 
要 原因 。 
不 管 使 用 哪个 测试 库 ,都 要 设法 解决 JavaScript 测试 面 对 的 主要 挑战 :管理 全 局 状态 。 
这 包括 : 
4 DOM/HTML 固件 ; 
4 命名 空间 ; 
e 理解 并 控制 执行 顺序 。 
我 说 JavaScript 4R-RE 4 JE 4b T fos, JavaScript 其 实 也 可 以 很 有 趣 。 不 过 我 还 是 
要 再 说 一 次 : 一 定 要 阅读 《JavaScript 语言 精粹 》。 
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S178 


部 署 新 代码 





现在 可 以 把 全 新 的 验证 代码 部 署 到 线 上 服务 器 了 。 借 此 机 会 ， 我 们 也 能 再 次 在 实践 中 使 用 
自动 化 部 署 脚本 。 


此 刻 ， 我 由 衷 地 感谢 Andrew Godwin 和 整个 Django 团队。 在 Django 1.7 之 
前 ， 我 写 了 很 长 一 节 内 容 ， 专 门 说 明 如 何 迁 移 。 现 在 ， 因 为 迁移 可 以 自动 执 
行 ， 所 以 那 整 节 内 容 都 不 需要 了 。 感 谢 你 们 的 辛勤 工作 


部 署 到 过 渡 服 务 器 
先 部 署 到 过 渡 服 务 器 中 ， 











17.1 


$ git push 
$ cd deploy_tools 


$ fab deploy:host=elspeth@superlists-staging.ottg.eu 
Disconnecting from superlists-staging.ottg.eu.. 
重启 Gunicorn: 





. done. 
elspeth@server:$ sudo systemctl restart gunicorn-superlists-staging.ottg.eu 
REELE A 2s ras HIA : 


$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 
OK 
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B 口 
17.2 ”部 署 到 线 上 服务 器 
假设 在 过 渡 服 务 器 上 一 切 正常 ， 那 么 就 可 以 运行 脚本 ， 部 署 到 线 上 服务 器 
$ fab deploy:host=elspeth@superlists.ottg.eu 


elspeth@server:$ sudo service gunicorn-superlists.ottg.eu restart 


TE 
17.3 ”如 果 看 到 数据 库 错 误 该 怎么 办 
迁移 中 引入 了 一 个 完整 性 约束 ， 你 可 能 会 发 现 迁移 执行 失败 ， 因 为 革 些 现 有 的 数据 违背 了 
约束 规则 。 
此 时 有 两 个 选择 。 
。 删除 服务 器 中 的 数据 库 ， 然 后 再 部 团 试 试 。 毕 况 这 只 是 一 个 小 项 目 ! 
。 或 者 ， 学 习 如 何 迁移 数据 (参见 附录 D), 


17.4 if: 为 这 次 新 发 布 打 上 Git 标 签 


最 后 要 做 的 一 件 事 是 ， 在 VCS 中 为 这 次 发 布 打上 标签 一 一 始终 能 跟踪 线 上 运行 的 是 哪个 
版 本 十 分 重要 : 

$ git tag -f LIVE # 需要 指定 -f， 因 为 我 们 要 替换 旧 标签 

$ export TAG-'date +DEPLOYED-%F /%H%M` 


$ git tag $TAG 
$ git push -f origin LIVE $TAG 























有 些 人 不 喜欢 使 用 push. -f， 也 不 喜欢 更 新 现 有 的 标签 ， 而 是 使 用 某 种 版 本 
号 标记 每 次 发 布 。 你 觉得 哪 种 方法 好 就 用 哪 种 。 














至 此 ， 第 二 部 分 结束 了 。 接 下 来 我 们 要 进入 第 三 部 分 ， 介 绍 更 让 人 兴奋 的 话题 。 真 邻 人 期 
待 啊 ! 
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部 署 过 程 回顾 
目前 我 们 部 署 过 好 几 次 了 ， 下 面 回顾 一 下 整个 过 程 。 
。 执行 git push 命令 ， 推 送 最 新 的 代码 。 

。 部 署 到 过 渡 服 务 器 ， 运 行 功能 测试 。 
。 部 署 到 线 上 服务 器 。 
。 为 最 新 的 版 本 打上 标签 。 


随 着 项 目的 增长 ， 部 署 过 程 会 变 得 越 来 越 复杂 。 如 果 没 有 好 的 自动 化 方案 ， 部 署 将 变 
得 难以 维护 ， 处 处 都 需要 自己 动手 检查 和 操作 。 这 个 话题 还 有 很 多 内 容 ， 不 过 已 经 超 
出 本 书 范畴 。 记 得 阅读 附录 C， 另 外 再 研究 一 下 “持续 部 署 ”。 
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第 三 部 分 


高 级 话题 





“ 噢 ， 天 呐 ， 什 么 ， 还 有 一 部 分 ? 哈 利 ， 我 累 了 ， 已 经 看 了 两 百 多 页 ， 觉 得 无 法 再 看 完 另 
一 部 分 了 ， 而 且 这 一 部 分 还 是 “高 级 ”话题 …… 我 能 不 能 跳 过 这 一 部 分 呢 ?” 

噢 ， 不 ， 你 不 能 。 这 一 部 分 虽然 被 称 为 “高 级 ”话题 ， 但 其 实 有 很 多 对 TDD 和 Web 开发 
十 分 重要 的 知识 ， 因 此 不 能 跳 过 。 这 一 部 分 甚至 比 前 两 部 分 还 重要 。 

我 们 会 讨论 如 何 集 成 和 测试 第 三 方 系统 。 重 用 现 有 的 组 件 对 现代 Web 开发 十 分 重要 。 还 
会 介绍 模拟 技术 和 测试 隔离 ， 这 两 种 技术 是 TDD 的 核心 ， 而且 在 最 简单 的 代码 基 中 也 会 
用 到 。 最 后 要 讨论 服务 器 端 调试 技术 和 测试 固件 ， 以 及 如 何 搭建 持续 集成 (Continuous 
Integration). 环境 。 这 些 技术 在 项 目 中 并 不 是 可 有 可 无 的 奢侈 附属 品 ， 它 们 其 实 都 很 重要 。 
这 一 部 分 的 学 习 曲线 难免 稍微 陡峭 一 些 。 你 可 能 要 多 读 几 遍 才 能 领会 ， 或 者 第 一 次 操 
作 时 可 能 无 法 正常 运行 , 需要 自己 调试 一 番 。 但 要 坚持 下 去 ， 知 识 越 难 ， 只 要 学 会 
了 ， 收 获 也 就 越 大 。 如 果 你 遇 到 难题 ， 我 十 分 乐意 帮忙 ， 请 给 我 发 电子 邮件 ， 地 址 是 


obeythetestinggoat ? gmail.com, 


来 吧 ， 我 保证 最 重要 的 知识 就 在 这 一 部 分 ! 
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98188 


用 户 身 份 验证 、 探 究 及 去 掉 探 究 代码 





精美 的 待 办 事项 清单 网 站 上 线 好 几 天 了 ， 用 户 开始 提供 反馈 。 他 们 说 :“ 我 们 喜欢 这 个 网 
站 ， 但 总 是 找 不 到 使 用 过 的 清单 ， 又 很 难 靠 死记 硬 背 来 记 住 URL。 如 果 网 站 能 记 住 我 们 创 
建 过 哪些 清单 就 好 了 。” 
还 记得 享 利 . 福特 说 过 的 那 句 “ 快 马 ” 名言 吗 ? ! 收 到 用 户 的 反馈 后 一 定 要 深入 分 析 并 
思考 :“ 用 户 真正 需要 的 是 什么 ?满足 用 户 的 需求 时 如 何 使 用 自己 一 直 想 尝试 的 酷 炫 
新 技术 ?” 

很 明显 ， 这 些 用 户 需 要 的 是 某 种 用 户 账户 系统 。 那 么 就 直接 实现 认证 功能 吧 。 

我 们 不 会 费力 气 自己 存储 密码 ， 这 是 20 世纪 90 年 代 的 技术 ， 而 且 存储 用 户 密码 还 是 个 安 
全 副 梦 ， 所 以 还 是 交 给 第 三 方 去 完成 吧 。 我 们 要 使 用 一 种 称 为 无 密码 验证 的 技术 。 

(如 果 你 坚持 要 自己 存储 密码 ， 可 以 使 用 Django 提供 的 auth 模块 。 这 个 模块 很 友好 也 很 简 
单 ， 具 体 的 实现 方法 留 给 你 自己 去 发 气 。) 


18.1 无 密码 验证 

为 了 不 自己 存储 密码 ， 我 们 要 使 用 什么 身份 验证 系统 呢 ? OAuth、OpenID， 还 是 “ 通 
过 Facebook 登录 ”? 对 我 来 说 ， 这 些 认 证 系统 都 有 让 人 无 法 接受 的 缺点 一 一 为 什么 要 让 
Google 或 Facebook 知道 我 何 时 登录 过 什么 网 站 呢 ? 

本 书 第 1 版 使 用 的 是 一 个 叫 “Persona” 的 实验 性 项 目 ， 这 个 项 目 由 Mozilla 一 些 具 有 理想 主义 
嬉 皮 士 精神 的 技术 人 员 研 发 。 但 可 惜 的 是 ， 它 如 今 已 被 废弃 。 










































































注 1: 享 利 : 福特 是 福特 汽车 公司 的 创始 人 。 这 里 所 说 的 “ 快 马 ” 名 言 全 句 是 :“If I had asked people what they 
wanted, they would have said faster horses.” 但 也 有 人 说 福特 并 没 说 过 这 句 话 。 译 者 注 
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但 我 找到 了 一 个 不 错 的 替代 方案 ， 这 种 身份 验证 方式 叫 作 “无 密码 验证 ”， 你 也 可 以 称 之 为 
“只 用 电子 邮件 验证 ”。 

发 明 这 个 系统 的 人 觉得 为 每 个 网 站 都 创建 密码 很 麻烦 ， 而 且 他 发 现 他 使 用 的 密码 都 是 随机 
的 ， 用 完 就 “ 扔 ”， 根 本 不 会 尝试 去 记 ， 等 到 再 需要 登录 时 使 用 “忘记 密码 ”功能 就 好 。 
详情 请 参阅 Medium 上 的 文章 名 为 “Passwords are Obselete" , 

无 密码 验证 系统 的 原理 是 ， 只 使 用 电子 邮件 地 址 确认 身份 。 既 然 你 希望 使 用 “忘记 密码 ” 功 
能 ， 就 说 明 你 信任 电子 邮件 地 址 ， 那 为 什么 不 直 捣 黄龙 呢 ?” 如 果 用 户 想 登录 ， 就 生成 一 个 唯 
一 的 URL， 通 过 电子 邮件 发 给 用 户 ， 用 户 点 击 URL 后 即 可 登录 网 站 。 


世界 上 没有 完美 的 系统 ， 为 了 给 线 上 网 站 提供 好 的 登录 方案 ， 需 要 深思 熟 虐 的 细节 有 很 多 。 
但 这 是 个 实验 性 项 目 ， 不 必 太 费心 。 


18.2 探索 性 编程 (又 名 “探究 ”) 
在 撰写 本 章 之 前 ， 我 对 无 密码 验证 的 认识 只 限于 前 文 给 出 的 那 篇 文章 中 的 简要 说 明 。 我 没 见 
过 具体 的 代码 ， 也 不 知道 应 该 从 哪 入 手 。 

我 们 在 第 13、14 章 中 见识 到 ， 可 以 使 用 单元 测试 探索 新 API 的 用 法 。 但 有 时 你 不 想 写 测 
试 ， 只 是 想 捣 鼓 一 下 ， 看 API 是 否 能 用 ， 目 的 是 学 习 和 领会 。 这 么 做 绝对 可 行 。 学 习 新 工 
H, 或 者 研究 新 的 可 行 性 方案 时 ， 一 般 都 可 以 适当 地 把 严格 的 TDD 流程 放 在 一 边 ， 不 编 
写 测 试 或 编写 少量 的 测试 ， 先 把 基本 的 原型 开发 出 来 。 测 试 山羊 并 不 介意 暂时 睁 一 只 眼 闭 
一 只 眼 。 
这 种 创建 原型 的 过 程 一 般 叫 作 “ 探 究 ”(spike)。 这 么 叫 的 原因 众所周知 。 

首先 ， 我 研究 了 现 有 的 Python 和 Django 身份 验证 码 ， 比 如 django-allauth 和 python-social- 
auth， 但 这 两 个 包 目 前 都 太 过 复杂 。( 回 头 一 想 ， 自 己 编程 多 有 趣 ! ) 

所 以 ， 我 决定 亲自 动手 ， 经 过 一 番 潜 心 研究 之 后 ， 终 于 写 出 了 刚好 能 用 的 代码 。 下 面 我 要 
向 你 展示 我 的 实现 过 程 ， 然 后 再 过 一 遍 ， 去 掉 探 索性 代码 ， 即 把 原型 替换 成 经 过 测试 、 可 
在 生产 环境 使 用 的 代码 。 

你 应 该 自己 动手 ， 把 这 些 代码 添加 到 自己 的 网 站 中 ， 这 样 才 能 得 到 试验 的 对 象 。 然 后 使 用 
自己 的 电子 邮件 地 址 登录 试 试 ， 证 明代 码 确实 可 用 。 


18.2.1 为 此 次 探究 新 建 一 个 分 支 


着 手 探究 之 前 ， 最 好 新 建 一 个 分 支 ， 这 样 就 不 用 担心 探究 过 程 中 提交 的 代码 把 VCS 中 的 
生产 代码 搞 乱 了 : 


$ git checkout -b passwordless-spike 


下 面 在 便签 上 记 下 希望 从 这 次 探究 中 学 到 的 东西 。 
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。 如 何 发 送 电子 邮 件 

。 生 成 和 识别 唯一 的 令 牌 
。 如 何在 Django 中 验证 身份 
。 用 户 要 经历 哪些 步骤 


A ate, af ti AAA 
18.2.2 前端 登录 U| 


先 从 前 端 入 手 。 在 导航 栏 中 放 一 个 表单 ， 让 用 户 输入 电子 邮件 地 址 ， 并 为 通过 身份 验证 的 
用 户 提供 退出 链接 : 





























lists/templates/base.html (ch161001) 


«body» 
«div class-"container"» 


«div class-"navbar'» 
(* if user.is authenticated %} 
«p»Logged in as {{ user.email]]«/p» 
<p><a id-"id logout" href="{% url 'logout' %}">Log out«/a»«/p» 
(* else *) 
«form method="POST" action ="{% url 'send login email' %}"> 
Enter email to log in: «input name-"email" type="text" /> 
{% csrf token X) 
</form> 
{% endif %} 
</div> 


<div class="row"> 


[2] 
18.2.3 从 Dijango 中 发 出 邮件 
登录 过 程 是 这 样 的 。 











。 有 人 想 登 录 时 ， 就 生成 一 个 唯一 的 秘密 令 牌 ， 存 储 在 数据 库 中 ， 并 与 他 的 电子 邮件 地 址 
关联 起 来 ， 然 后 把 令 牌 发 给 那个 人 。 

。 他 查看 电子 邮件 ， 里 面 有 个 包含 令 牌 的 URL, 

。 他 点 击 链接 后 ， 我 们 检查 令 牌 是 否 存 在 于 数据 库 中 ， 如 果 存 在 就 登入 相应 的 用 户 。 


首先 ， 为 账户 准备 一 个 应 用 : 
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$ python manage.py startapp accounts 
然后 在 urls.py 中 至 少 设置 一 个 URL。 先 是 位 于 顶级 的 superlists/urls.py 文件 。 


superlists/urls.py (ch161003) 


from django.conf.urls import include, url 
from lists import views as list views 

from lists import urls as list urls 

from accounts import urls as accounts urls 


urlpatterns - [ 
url(r'^$', list views.home page, name-'home'), 
url(r'^lists/', include(list urls)), 
url(r'^accounts/', include(accounts urls)), 


] 
然后 是 accounts 模块 中 的 urls.py 文件 : 


accounts/urls.py (ch161004) 


from django.conf.urls import url 
from accounts import views 


urlpatterns - [ 
url(r'^send email$', views.send login email, name-'send login email'), 


] 
下 述 视图 负责 创建 与 用 户 在 登录 表单 中 输入 的 电子 邮件 地 址 关联 的 令 牌 : 








accounts/views.py (ch161005) 


import uuid 

import sys 

from django.shortcuts import render 
from django.core.mail import send mail 


from accounts.models import Token 


def send login email(request): 
email = request.POST['email'] 
uid = str(uuid.uuid4()) 
Token.objects.create(email-email, uid-uid) 
print('saving uid', uid, 'for email', email, file-sys.stderr) 
url = request.build absolute uri(f'/accounts/login?uid-(uid]') 
send mail( 
'Your login link for Superlists', 
f'Use this link to log in:\n\n{url}', 
'noreplyüsuperlists', 
[email], 
) 


return render(request, 'login email sent.html') 


为 此 ， 我 们 要 显示 一 条 消息 ， 指 明 电子 邮件 已 经 发 出 : 








LL 
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accounts/templates/login email sent.html (ch161006) 


«html» 
«hi-»Email sent«/hi1» 


«p»Check your email, you'll find a message with a link that will log you into 
the site.«/p» 


</html> 
(这 段 代码 只 是 临时 的 ， 实 际 使 用 中 应 该 集成 到 base.html 模板 里 。) 


为 了 让 Django 的 send mail 函数 工作 ， 更 重要 的 是 告诉 Django 我 们 的 电子 邮件 服务 器 地 
址 。 我 暂时 先 使 用 自己 的 Gmail 账户 。? 你 可 以 使 用 任何 你 想 用 的 电子 邮件 服务 提供 商 ， 只 
要 支持 SMTP 就 行 : 





super lists/settings.py (ch161007) 


EMAIL HOST = 'smtp.gmail.com' 

EMAIL HOST USER = 'obeythetestinggoat(jgmail.com' 
EMAIL HOST PASSWORD - os.environ.get('EMAIL PASSWORD') 
EMAIL PORT = 587 

EMAIL USE TLS - True 


如 果 你 也 想 使 用 Gmail， 可 能 需要 访问 Google 账户 的 安全 设置 页 面 。 如 果 
你 在 使 用 双 因素 身份 验证 ， 可 能 需要 设置 应 用 专用 的 密码 ， 如 果 没 用 双 因 素 
身份 验证 ， 可 能 也 要 允许 较 不 安全 的 应 用 访问 。 鉴 于 此 ， 你 可 以 新 建 一 个 
Google 账户 ， 而 不 使 用 包含 敏感 数据 的 账户 。 


18.2.4 ”使 用 环境 变量 ， 避 免 源 码 中 出 现 机 密 信息 
每 个 项 目 终究 都 要 以 一 种 方式 处 理 “机 密 信 息 ” 一 一 像 电子 邮件 密码 或 API 密 钥 这 类 不 想 
和 整个 世界 分 享 的 数据 。 如 果 你 的 仓库 是 私有 的 ， 或 许 还 可 以 存储 在 Git 中 ， 但 事实 往往 
不 是 这 样 。 而 且 这 还 涉及 在 开发 和 生产 环境 中 使 用 不 同 的 设置 。( 还 记得 在 第 11 章 中 我 们 
是 如 何 处 理 Django 的 SECRET. KEY 设置 的 吗 ? ) 
这 种 配置 通常 使 用 环境 变量 存储 ， 上 述 代 码 中 的 0s .environ.get 就 是 用 于 读 取 环境 变量 的 。 
为 此 ， 我 要 在 运行 开发 服务 器 的 shell 中 设 定 环境 变量 : 

$ export EMAIL PASSWORD-"sekrit" 


Ed zt CEDE AS s PRIA E 






























































后 








注 2: 我 刚刚 是 不 是 说 了 一 大 堆 关 于 使 用 Google 登录 对 隐私 有 多 大 影响 的 话 ? 那 为 什么 现在 又 要 使 用 Gmail 
呢 ? 是 的 ， 这 的 确 相 互 矛盾 。( 老 实 讲 ， 有 一 天 我 会 抛弃 Gmail 的 ! ) 但 这 里 只 是 用 于 测试 ， 我 又 没 强 
制 用 户 使 用 Google. 
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18.2.5 “在 数据 库 中 存储 令 牌 


情况 进展 如 何 ? 








. 如 发 z% 电 8 

。 生 成 和 识别 叭 一 的 今 牌 
。 如 何在 Django 中 验证 身份 
。 用 户 要 经历 哪些 步 又 
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为 了 把 令 牌 存储 在 数据 库 中 ， 我 们 需要 一 个 模型 。 这 个 模型 要 把 电子 邮件 地 址 与 唯一 的 ID 
关联 起 来 一 一 这 没什么 难 的 : 


accounts/models.py (ch161008) 
from django.db import models 
class Token(models.Model): 


email - models.EmailField() 
uid - models.CharField(max length-255) 


18.2.0 HEX B A EUER RE 
既然 已 经 谈 到 模型 了 ， 那 就 试验 一 下 如 何在 Diango 中 验证 身份 吧 。 








. e 发 一 d xm " 





e + 成 da45 唯一 的 今 牌 
。 如 何在 Django 中 验证 身份 
。 用 户 要 经 历 哪些 步骤 








A ate af uti AAA 
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首先 ， 要 有 一 个 用 户 模 型 。 在 我 刚 开 始 编写 时 ， 自 定义 用 户 模型 还 是 Django 的 新 特性 ， 
所 以 我 仔细 研读 了 Django 的 身份 验证 文档 ， 努 力 找 出 最 简单 的 方法 : 


accounts/models.py (ch161009) 








[Ses] 
from django.contrib.auth.models import ( 
AbstractBaseUser, BaseUserManager, PermissionsMixin 


) 


class ListUser(AbstractBaseUser, PermissionsMixin): 
email = models.EmailField(primary key-True) 
USERNAME FIELD = 'email' 
HREQUIRED FIELDS - ['email', 'height'] 


objects = ListUserManager() 


(property 
def is staff(self): 
return self.email -- 'harry.percivalQexample.com' 


(property 
def is active(self): 
return True 
这 算是 一 个 极 简 用 户 模 型 ， 它 只 有 一 个 字段 ， 没 有 名 字 、 姓 氏 或 用 户 名 之 类 的 ， 尤 其 是 没 
有 密码 字段 。 我 们 不 必 为 此 操心 ! 
但 我 要 再 次 说 明 ， 这 段 代 码 不 适合 在 生产 环境 使 用 ， 里 
我 的 电子 邮件 地 址 。 去 掉 试探 代码 时 会 做 大 幅 调 整 。 


此 外 ， 还 要 为 用 户 模型 提供 一 个 模型 管理 器 : 


























看 注释 掉 了 一 行 代码 ， 还 硬 编码 了 


























accounts/models.py (ch161010) 
[...] 


class ListUserManager(BaseUserManager): 


def create user(self, email): 
ListUser.objects.create(email-email) 


def create superuser(self, email, password): 
self.create user(email) 


现 阶 段 你 不 用 管 模型 管理 器 是 什么 ， 目 前 就 是 需要 这 么 一 个 东西 ， 有 了 它 才 能 工作 。 去 掉 
试探 代码 时 ， 我 们 会 分 析 每 一 段 代 码 ， 确 定 哪些 是 可 以 在 生产 环境 使 用 的 ， 彻 底 弄 明白 这 
些 代码 的 作用 。 


18.2.7 ”结束 自 定 义 Django 身 份 验证 功能 


就 要 完成 了 。 最 后 一 步 要 识别 令 牌 然后 登入 用 户 。 做 完 这 一 步 ， 便签 上 记录 的 事项 基本 
上 都 可 以 划 掉 了 。 
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。 告 总 和 说 别 唯一 的 今 牌 

。 如 何在 Django 中 验证 身份 
。 用 户 要 经历 哪些 步 又 




















A ate af ti Pm t mm 


下 面 是 点 击 电子 邮件 中 的 链接 后 触发 的 视图 : 























accounts/views.py (ch161011) 


import uuid 

import sys 

from django.contrib.auth import authenticate 

from django.contrib.auth import login as auth login 
from django.core.mail import send mail 

from django.shortcuts import redirect, render 


[...] 


def login(request): 
print('login view', file-sys.stderr) 
uid - request.GET.get('uid') 
user - authenticate(uid-uid) 
if user is not None: 
auth login(request, user) 
return redirect('/') 


authenticate 函数 调用 Django 的 身份 验证 框架 ， 我 们 已 经 将 它 配置 为 使 用 “ 自 定 义 的 身份 
验证 框架 "， 作 用 是 验证 UID ， 返 回电 子 邮 件 对 应 的 用 户 。 


我 们 本 可 以 在 这 个 视图 中 直接 结束 ， 但 是 最 好 按照 Django 预期 的 方式 组 织 代码 ， 实 现 关 
注 点 分 离 : 











accounts/authentication.py (ch161012) 


import sys 
from accounts.models import ListUser, Token 


class PasswordlessAuthenticationBackend(object): 


def authenticate(self, uid): 
print('uid', uid, file-sys.stderr) 
if not Token.objects.filter(uid-uid).exists(): 
print('no token found', file-sys.stderr) 
return None 
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token = Token.objects.get(uid-uid) 
print('got token', file-sys.stderr) 
try: 
user - ListUser.objects.get(email-token.email) 
print('got user', file-sys.stderr) 
return user 
except ListUser.DoesNotExist: 
print('new user', file-sys.stderr) 
return ListUser.objects.create(email-token.email) 


def get user(self, email): 
return ListUser.objects.get(email-email) 


这 段 代 码 也 不 例外 ， 打 印 了 很 多 调试 信息 ， 还 有 一 些 重复 ， 不 适合 在 生产 环境 使 用 。 不 过 
我 们 现在 要 的 是 能 用 就 行 。 


最 后 ， 编 写 退 出 视图 : 











accounts/views.py (ch161013) 


from django.contrib.auth import login as auth login, logout as auth logout 


[5:554] 


def logout(request): 
auth logout(request) 
return redirect('/') 








把 login 和 Logout 视图 添加 到 urls.py FP: 


accounts/urls.py (ch161014) 


from django.conf.urls import url 
from accounts import views 


urlpatterns - [ 
url(r'^send email$', views.send login email, name-'send login email'), 
url(r'^login$', views.login, name-'login'), 
url(r'^logout$', views.logout, name-'logout'), 


] 


坚持 住 ， 就 快 结束 了 ! 在 settings.py 中 启用 auth 后 端 和 这 个 accounts 应 用 : 





super lists/settings.py (ch161015) 


INSTALLED APPS - [ 
i'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'lists', 

'accounts', 


] 


AUTH USER MODEL = 'accounts.ListUser' 





AUTHENTICATION BACKENDS = [ 


'accounts.authentication.PasswordlessAuthenticationBackend', 


] 


MIDDLEWARE - [ 
[ec] 


执行 makemigrations 命令 ， 为 令 牌 和 用 户 模 型 生成 迁移 : 


$ python manage.py makemigrations 
Migrations for 'accounts': 
accounts/migrations/0001 initial.py 
- Create model ListUser 
- Create model Token 


再 执行 migrate 命令 构建 数据 库 : 


$ python manage.py migrate 
[s] 
Running migrations: 
Applying accounts.0001_initial... OK 





一 切 就 绪 ! 为 什么 不 执行 runserver 命令 启动 开发 服务 器 ， 看 看 实际 效果 呢 〈 见 图 





18-1) ? 





from accounts.model 
Inbox - obeythetestinggoat(Qgmail.com - Mozilla Firefox 
f^ Inbox - obeythetestin.. x | + 


(€) il; (0 @ | https://inbox.google.com/u/1/ 


Today 


| Logout 
http://localh...s/send. email x 


€ 
© metome :> 
AS 


Use this link to log in: Email sent 


http://localhost:8000/a ý " 
d4c5-4912-9618-809b! Check your email, you'll fint 


into the site. 


Your login link for Superlists 


i) localhost:8000/accounts/ 


Reply 


*» 10s 


uid=uid) 
email, file 


To-Do lists - Mozilla Firefox 


To-Do lists xc 
i) localhost:8000 


| Logged in as obeythetestinggoat(? gmail.com 


Start a new To-Do list 





& 











18-1. 能 正常 使 用 ! 能 正常 使 用 ! 哇 哈哈 














大 概 就 是 这 样 ! 这 一 过 程 看 着 简单 ， 但 我 当时 可 是 历经 磨难 











如 果 遇 到 SMTPSenderRefused HIRE, "IHE TIUS T ETF A M 26 ax HJ 
shell 中 设 定 EMAIL PASSWORD 环境 变量 。 
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处 设置 了 好 和 久 ， 又 在 自 定义 用 户 模 型 的 过 程 中 少 写 了 几 个 属性 (因为 我 没 认 真 阅读 文档 )， 
甚至 还 以 为 自己 发 现 了 一 个 缺陷 而 换 到 Django 开发 版 本 ， 不 过 最 终 证 明 那 并 不 是 缺陷 。 

















在 stderr 中 记录 错误 
探究 时 尤为 重要 的 一 点 是 能 看 到 代码 抛 出 的 异常 。Django 很 讨厌 ， 默 认 情 况 下 并 没 把 
所 有 异常 都 输送 到 终端， 不 过 可 以 在 settings.py 中 使 用 LOGGING 变量 让 Django 这 么 做 : 





super lists/settings.py (ch161017) 


LOGGING = ( 
'version': 1, 
'disable existing loggers': False, 
'handlers': { 
'console': { 
'level': 'DEBUG', 


'class': 'logging.StreamHandler', 
ir 
J; 
'loggers': { 
'django': { 
'handlers': ['console'], 
f; 
F 


'root': {'level': 'INFO'}, 
} 
Django 使 用 的 是 Python 标准 库 中 的 企业 级 日 志 包 。 这 个 包 虽 然 功 能 完善 ， 但 是 学 习 曲 
线 太 陡 。 第 21 章 将 简单 介绍 一 下 这 个 包 ，Django 文档 中 有 更 详细 的 说 明 。 














但 不 管 怎么 说 ， 我 们 都 实现 了 一 个 可 用 的 方案 ! 下 面 提交 到 passwordless-spike 分 支 : 
$ git status 


$ git add accounts 
$ git commit -am "spiked in custom passwordless auth backend" 


接 下 来 该 去 掉 探 究 代 码 了 。 


18.3 ”去掉 探究 代码 


去 掉 探究 代码 意味 着 要 使 用 TDD 重 写 原型 代码 。 我 们 现在 掌握 了 足够 的 信息 ， 知 道 怎么 
做 才 是 对 的 。 那 第 一 步 做 什么 呢 ? 当然 是 编写 功能 测试 ! 


我 们 还 得 继续 竺 在 passwordless-spike 分 文中 ， 看 功能 测试 能 否 在 探究 代码 中 通过 ， 然 后 
再 回 到 master 分 支 ， 并 且 只 提交 功能 测试 。 


下 面 是 我 们 编写 的 第 一 版 功能 测试 ， 很 简单 : 
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o 


functional tests/test login.py 


from django.core import mail 

from selenium.webdriver.common.keys import Keys 
import re 

from .base import FunctionalTest 

TEST EMAIL = 'edithQexample.com' 

SUBJECT = 'Your login link for Superlists' 


class LoginTest(FunctionalTest): 


def test can get email link to log in(self): 














# 伊 迪 丝 访问 这 个 很 棒 的 超级 列表 网 站 

# 第 一 次 注意 到 导航 栏 中 有 “登录 ”区 域 

# 看 到 要 求 输 入 电子 邮件 地 址 ， 她 便 输入 了 
self.browser.get(self.live server url) 
self.browser.find element by name('email').send keys(TEST EMAIL) 
self.browser.find element by name('email').send keys(Keys.ENTER) 






































# 出 现 一 条 消息 ， 告 诉 她 邮件 已 经 发 出 

self.wait for(lambda: self.assertIn( 
'Check your email', 
self.browser.find element by tag name('body').text 








)) 


# 她 查看 邮件 ， 看 到 一 条 消息 
email = mail.outbox[0] © 
self.assertIn(TEST EMAIL, email.to) 
self.assertEqual(email.subject, SUBJECT) 


# 邮件 中 有 个 URL 链 接 
self.assertIn('Use this link to log in', email.body) 
url search = re.search(r'http://.*/.4$', email.body) 
if not url search: 
self.fail(f'Could not find url in email body:\n{email.body}') 
url = url search.group(0) 
self.assertIn(self.live server url, url) 


# 她 点 击 了 链接 


self.browser.get(url) 




















# 她 登录 了 1 
self.wait for( 

lambda: self.browser.find element by link text('Log out') 
) 
navbar = self.browser.find element by css selector('.navbar') 
self.assertIn(TEST EMAIL, navbar.text) 





你 是 不 是 





>H 











运行 这 个 功能 测试 ， 它 能 通过 : 


运行 测试 时 ，Django 允许 通过 matl.outbox 属性 访问 服务 器 发 送 的 电子 邮件 。 稍 后 再 
说 明 如 何 检查 “真实 的 ”电子 邮件 CREER). 


不 知 如 何在 测试 中 获取 邮件 内 容 而 担心 ? 好 消息 是 ， 我 们 暂时 可 以 作 次 1 
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$ python manage.py test functional tests.test login 
[4 

Not Found: /favicon.ico 

saving uid [...] 

login view 

uid [...] 

got token 

new user 


Ran 1 test in 3.729s 
OK 


你 甚至 会 看 到 我 在 探究 视图 的 实现 时 留 下 的 调试 输出 。 现 在 该 还 原 这 些 临时 改动 ， 然 后 再 
以 测试 驱动 的 方式 重新 逐一 介绍 了 。 


删除 探究 代码 


$ git checkout master # 切换 到 master 分 支 
$ rm -rf accounts # 删除 所 有 探究 代码 

$ git add functional tests/test login.py 
$ git commit -m "FT for login via email" 


然后 再 次 运行 功能 测试 ， 让 它 驱 动 我 们 开发 : 


$ python manage.py test functional tests.test login 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 


element: [name-"email"] 


Ex] 


测试 首先 要 求 我 们 添加 一 个 电子 邮件 地 址 输入 框 。Bootstrap 为 导航 栏 提供 了 内 置 类 ， 我 们 
将 使 用 它们 。 这 个 输入 框 放 在 一 个 表单 里 : 














lists/templates/base.html (ch161020) 


«div class-"container"» 


«nav class-"navbar navbar-default" role-"navigation"» 
«div class-"container-fluid"» 
«a class-"navbar-brand" hrefz"/"»Superlists«/a» 
«form class-"navbar-form navbar-right" method="POST" action="#"> 
«span»Enter email to log in:«/span» 
«input class-"form-control" name-"email" type="text" /> 
{% csrf token %} 
</form> 
</div> 
</nav> 


«div class="row"> 


[255] 
现在 功能 测试 是 失败 的 ， 因 为 这 个 登录 表单 什么 也 没 做 : 








$ python manage.py test functional tests.test login 

[ss] 

AssertionError: 'Check your email' not found in 'SuperlistsWMnEnter email to log 
in:\nStart a new To-Do list' 


我 建议 你 现在 像 前 面 说 过 的 那样 设置 L0GGING。 现 在 没 必要 特别 测试 这 个 ， 
目前 的 测试 组 件 会 在 出 现 异常 时 通知 我 们 。 到 第 21 章 你 会 发 现 ， 这 个 设置 
对 调试 非常 有 用 。 




















该 编写 一 些 Django 代码 了 。 首 先 ， 创 建 一 个 名 为 accounts 的 应 用 ， 用 于 存放 与 登录 有 关 
的 所 有 文件 : 


$ python manage.py startapp accounts 
你 现在 还 可 以 提交 一 次 ， 把 应 用 的 占 位 文件 与 后 面 的 修改 区 分 开 。 
下 面 来 重新 构建 这 个 极 简 的 用 户 模 型 ， 不 过 这 一 次 有 测试 。 看 看 是 否 比 探究 时 的 更 简洁 。 


18.4 一 个 极 简 的 自 定义 用 户 模型 


Django 内 置 的 用 户 模型 对 记录 用 户 信 息 做 了 各 种 设想 , 明确 要 记录 的 包括 名 和 姓 ”, 而 且 强 
制 使 用 用 户 名 。 我 坚信 ， 除 非 真 的 需要 ， 否 则 不 要 存储 用 户 的 任何 信息 。 所 以 ， 一 个 只 记 
录 电 子 邮件 地 址 的 用 户 模型 对 我 来 说 足够 了 。 


我 相信 你 已 经 知道 我 们 应 该 创建 tests 文件 夹 ， 并 在 其 中 创建 _init_.py 文件 ， 然 后 删除 
tests.py , ak test_models.py， 写 入 下 述 内 容 : 


















































accounts/tests/test models.py (ch161024) 


from django.test import TestCase 
from django.contrib.auth import get user model 


User = get user model() 


class UserModelTest(TestCase): 


def test user is valid with email only(self): 
user = User(email-'aQb.com') 
user.full clean() # 不 该 抛 出 异常 


测试 的 结果 是 一 个 预期 失败 ， 


django.core.exceptions.ValidationError: ('password': ['This field cannot be 
blank.'], 'username': ['This field cannot be blank.']) 


密码 ? 用 户 名 ? 不 ! 把 模型 写成 这 样 如 何 ? 











注 3: mA Django 的 重要 维护 者 对 这 个 决策 并 不 后 悔 ， 但 并 非 每 个 人 都 有 名 和 姓 。 
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accounts/models.py 


from django.db import models 


class User(models.Model): 
email - models.EmailField() 














然后 在 settings.py 中 把 accounts 应 用 添加 到 INSTALLED APPS 中 ， 再 设 定 AUTH USER MODEL; 








super lists/settings.py (ch161026) 


INSTALLED APPS - [ 
i&'django.contrib.admin', 
'django.contrib.auth', 
'django.contrib.contenttypes', 
'django.contrib.sessions', 
'django.contrib.messages', 
'django.contrib.staticfiles', 
'lists', 

'accounts', 


] 


AUTH USER MODEL = 'accounts.User' 


现在 得 到 的 错误 与 数据 库 有 关 : 
django.db.utils.OperationalError: no such table: accounts user 


与 之 前 一 样 ， 这 表明 我 们 要 执行 迁移 。 但 当 我 们 执行 迁移 时 ，Django 又 会 抱怨 用 户 模型 缺 


$ python manage.py makemigrations 
Traceback (most recent call last): 


Eais] 
if not isinstance(cls.REQUIRED_FIELDS, (list, tuple)): 
AttributeError: type object 'User' has no attribute 'REQUIRED_FIELDS' 


E, Django 啊 ， 这 个 模型 具有 一 个 字段 而 已 ， 你 自己 应 该 能 找到 问题 的 答案 啊 。 既 然 你 不 
能 ， 那 我 就 提供 给 你 吧 : 

















accounts/models.py 


class User(models.Model): 
email - models.EmailField() 
REQUIRED FIELDS - [] 


还 有 疑问 吗 ?“ 


$ python manage.py makemigrations 


[5:2] 
AttributeError: type object 'User' has no attribute 'USERNAME FIELD' 





注 4: 你 可 能 想 问 ， 既 然 我 觉得 Django 很 策 ， 为 什么 不 提交 “合并 请 求 ”(pull request) 修正 呢 ? 这 个 问题 应 
该 很 容易 修正 。 嗯 ， 我 保证 等 我 写 完 这 本 书 之 后 会 这 么 做 的 。 尖 锐 的 批评 就 此 打住 吧 ! 




















经 过 几 次 失败 之 后 ， 得 到 的 模型 如 下 所 示 : 


accounts/models.py 


class User(models.Model): 
email - models.EmailField() 


REQUIRED FIELDS - [] 
USERNAME FIELD = 'email' 
is anonymous - False 
is authenticated - True 


现在 出 现 的 错误 稍 有 不 同 : 


$ python manage.py makemigrations 
SystemCheckError: System check identified some issues: 





ERRORS: 
accounts.User: (auth.E003) 'User.email' must be unique because it is named as 
the 'USERNAME FIELD'. 


好 吧 ， 可 以 这 样 修正 : 





accounts/models.py (ch161028- 1) 


email - models.EmailField(unique-True) 


现在 能 成 功 迁移 了 : 


$ python manage.py makemigrations 
Migrations for 'accounts': 
accounts/migrations/0001 initial.py 
- Create model User 


测试 也 能 通过 了 : 
$ python manage.py test accounts 


Ran 1 tests in 0.001s 
OK 


不 过 用 户 模型 比 想象 的 复杂 了 一 上 点 ， 除 了 email 字段 之 外 ， 还 有 自动 生成 的 ID 字段 ， 用 
作 主 键 。 这 个 模型 可 以 进一步 简化 ! 


把 测试 当 作 文档 


下 面 我 们 要 把 email 字段 设 为 主键 ,“ 因而 必须 把 自动 生成 的 id 字段 删除 。 


我 们 可 以 直接 这 么 做 ,测试 也 不 会 失败 ， 然 后 信心 满 满 地 声称 这 “只 是 一 次 重 构 ”"。 但 是 
最 好 为 此 专门 编写 一 个 测试 : 








7 























注 5: 其 实 电 子 邮 件 地 址 不 太 适 合作 为 主键 。 一 位 深 受 其 害 的 读者 写 了 一 封 邮件 给 我 ,控诉 了 他 们 这 十 几 年 来 
使 用 电子 邮件 地 址 作为 主键 遇 到 的 各 种 问题 (因为 这 样 无 法 管理 多 用 户 账户 )。 所 以 ， 还 是 那 句 话 ， 具 
体 问 题 具 体 分 析 。 
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accounts/tests/test models.py (ch161028-3) 
def test email is primary key(self): 


user = User(email-'aQb.com') 
self.assertEqual(user.pk, 'aQb.com') 


如 有 果 以 后 回 过 头 再 看 代码 ， 这 个 测试 能 唤起 我 们 的 记忆 ， 想 起 曾经 做 过 这 次 修改 。 


self.assertEqual(user.pk, 'aQb.com') 
AssertionError: None !- 'a(bb.com' 


测试 可 以 作为 一 种 文档 形式 ， 因 为 测试 体现 了 你 对 某 个 类 或 函数 的 需求 。 如 
果 你 忘记 了 为 什么 要 用 茶 种 方法 编写 代码 ， 可 以 回 过 头 来 看 测试 ， 有 时 就 能 


找到 答案 。 这 就 是 一 定 要 给 测试 方法 起 个 意思 明确 的 名 字 的 原因 

















o 


实现 的 方式 如 下 (可 以 先 使 用 unique=True， 看 看 结果 如 何 ) : 


accounts/models.py (ch161028-4) 
email - models.EmailField(primary key-True) 


一 定 不 能 忘 了 调整 迁移 : 


$ rm accounts/migrations/0001 initial.py 


$ python manage.py makemigrations 
Migrations for 'accounts': 


accounts/migrations/0001 initial.py 
- Create model User 


现在 两 个 测试 都 能 通过 : 
$ python manage.py test accounts 
[. 


Ran 2 tests in 0.001s 
OK 


18.5 令 牌 模型 : 把 电子 邮件 地 址 与 唯一 的 ID 关 


联 起 来 
接 下 来 构建 一 个 令 牌 模型 。 下 面 是 个 简短 的 单元 测试 ， 能 捕获 基本 的 问题 


子 邮 件 地 址 关联 到 唯一 的 ID 上 ， 而 且 ID 不 能 在 一 行 中 重复 出 现 : 








应 该 能 把 电 


i 























accounts/tests/test models.py (ch161030) 


from accounts.models import Token 


[...] 


class TokenModelTest(TestCase): 





def test links user with auto generated uid(self): 
token1 = Token.objects.create(email-'a(bb.com') 
token2 = Token.objects.create(email-'a(bb.com') 
self.assertNotEqual(tokeni.uid, token2.uid) 


使 用 TDD 驱动 开发 Django 模型 要 历经 几 番 波 折 ， 因 为 这 涉及 迁移 ， 所 以 我 们 将 像 这 样 选 
代 多 次 : 微 改 代码 、 创 建 迁移 、 遇 到 新 错误 、 删 除 迁移 、 重 新 创建 迁移 、 再 修改 代码 …… 


$ python manage.py makemigrations 
Migrations for 'accounts': 
accounts/migrations/0002 token.py 
- Create model Token 
$ python manage.py test accounts 
[...] 


TypeError: 'email' is an invalid keyword argument for this function 
我 相信 你 能 按部就班 走 完整 个 过 程 。 记 住 ， 虽 然 我 看 不 见 你 ， 但 是 测试 山羊 能 ! 


$ rm accounts/migrations/0002 token.py 
$ python manage.py makemigrations 
Migrations for 'accounts': 
accounts/migrations/0002 token.py 
- Create model Token 
$ python manage.py test accounts 
AttributeError: 'Token' object has no attribute 'uid' 


最 终 写 出 的 模型 代码 如 下 : 

















accounts/models.py (ch161033) 
class Token(models.Model): 


email - models.EmailField() 
uid - models.CharField(max length-40) 
得 到 的 错误 是 : 
$ python manage.py test accounts 


[7] 


self.assertNotEqual(tokeni.uid, token2.uid) 


vi 11 


AssertionError: az 


现在 要 决定 如 何 生成 随机 的 唯一 ID 字段 。 我 们 可 以 使 用 random 模块 ， 但 是 Python 自 带 的 
另 一 个 模块 是 专门 用 于 生成 唯一 ID 的 ， 名 为 “uuid”(universally unique id 的 简称 ) 。 


它 的 用 法 如 下 : 





accounts/models.py (ch161035) 


import uuid 


[552] 


class Token(models.Model): 
email - models.EmailField() 
uid = models.CharField(default-zuuid.uuid4, max length-40) 
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再 调整 一 下 迁移 ， 测 试 便 能 通过 ; 


$ python manage.py test accounts 
[5:25] 
Ran 3 tests in 0.015s 


OK 


不 错 ， 逐 渐 走 上 正轨 了 一 一 至 少 模型 层 完成 了 。 下 一 章 将 介绍 模拟 技术 ， 这 是 测试 外 部 依 
赖 (例如 邮件 ) 的 关键 技术 。 








探索 性 编程 、 探 究 及 去 掉 探 究 代码 
RÈ 
为 了 学 习 新 API 或 调查 新 方案 的 可 行 性 而 做 的 探索 性 编程 。 没有 测试 也 能 探 完 。 最 
好 在 一 个 新 分 支 中 探 完 ， 去掉 探究 代码 时 再 回 到 主 分 支 。 
去 掉 探 究 代 码 
把 探究 所 得 应 用 到 真实 的 代码 基 中 。 要 完全 握 弃 探究 代码 ， 然 后 从 头 开 始 ， 用 
TDD 流程 再 实现 一 次 。 去 掉 探 完 代 码 后 实际 编写 的 代码 往往 与 最 初 有 很 大 不 同 ， 
而 且 通 常 更 好 。 
针对 探 完 代码 编写 功能 测试 
么 做 要 视 情 况 而 定 。 支 持 这 么 做 的 人 认为 ， 这 样 有 助 于 正确 编写 功能 测 
测试 探究 的 方法 与 探究 本 身 一 样 具 有 挑战 性 ; 不 支持 这 么 做 的 人 觉得 这 
T Li 完 时 很 像 一 一 我 们 要 力求 避免 这 种 情况 。 
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第 19 章 


使 用 驭 件 测试 外 部 依赖 或 减少 重复 




















本 章 开始 说 明 如 何 测 试 发 送 电 子 邮 件 的 代码 。 通 过 前 面 的 功能 测试 ， 我 们 得 知 Django tE 
供 了 获取 所 发 送 邮件 的 方式 ， 即 mail.outbox 属性 。 不 过 我 想 在 这 一 章 演示 一 种 十 分 重要 
的 测试 技术 ， 叫 作 模 拟 技术 。 鉴 于 此 ， 本 章 的 单元 测试 将 假装 Django 没有 提供 这 样 的 便 
捷 方 式 。 




















我 是 说 不 能 使 用 Django 的 mail.outbox 吗 ? 不 是 。 你 应 该 使 用 它 ， 因 为 它 很 
便利 。 但 是 我 想 教 你 模拟 技术 ， 因 为 这 是 在 单元 测试 中 测试 外 部 依赖 的 通用 
方式 。 和 毕 况 你 不 会 一 直 使 用 Django。 即 便 如 此 ， 除 了 发 送 电 子 邮 件 之 外 还 有 
很 多 操作 ， 只 要 与 第 三 方 API 交互 都 适合 使 用 驭 件 测试 。 


19.1 开始 之 前 布 好 基本 管道 


首先 设置 一 个 基本 的 视图 和 URL。 编 写 一 个 简单 的 测试 ， 检 查 发 送 登录 邮件 的 URL 最 终 
会 重 定向 到 首页 : 









































accounts/tests/test views.py 


from django.test import TestCase 


class SendLoginEmailViewTest(TestCase): 


def test redirects to home page(self): 
response = self.client.post('/accounts/send login email', data-( 
'email': 'edithQexample.com' 
n 


self.assertRedirects(response, '/') 
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我 们 已 经 在 accounts/urls.py 中 设置 了 urL， 也 在 superlists/urls.py 中 使 用 include 引入 了 ， 
再 加 上 下 述 代 码 ， 这 个 测试 便 能 通过 : 


accounts/views.py 


from django.core.mail import send mail 
from django.shortcuts import redirect 


def send login email(request): 
return redirect('/') 


现在 导入 send mait 函数 只 是 占 个 位 子 : 
$ python manage.py test accounts 
Ran 4 tests in 0.015s 
OK 


好 的 ， 有 切入 点 了 ,下面 开始 使 用 模拟 技术 。 


19.2 ”自己 动手 模拟 〈 打 猴子 补丁 ) 


在 真实 情况 中 ， 我 们 调用 send mail 时 希望 Django 连接 电子 邮件 服务 提供 商 ， 通 过 网 络 把 
真实 的 电子 邮件 发 送出 去 。 但 这 不 是 我 们 希望 在 测试 中 发 生 的 。 代 码 有 外 部 副作用 时 也 是 
如 此 ， 例 如 调用 API、 发 推 文 、 发 短信 ， 等 等 。 在 单元 测试 中 ， 我 们 并 不 想 真 的 通过 互联 
网 发 推 文 或 调用 API。 可 是 ,我 们 必须 找到 一 种 方法 , 测试 代码 是 否 正确 。 双 件 ' 正 是 我 们 
寻找 的 答案 。 

恰好 ，Python 的 优势 之 一 是 它 的 动态 本 性 ， 这 样 十 分 有 利于 模拟 ， 我 们 有 时 称 这 样 的 做 法 
为 打 猴 子 补丁 。 首 先 ， 假 设 调用 send matt 时 要 设 定 邮件 主题 、 发 件 地 址 和 收 件 地 址 ， 比 
如 像 下 面 这 样 : 





















































accounts/views.py 


def send login email(request): 

email = request.POST['email'] 

# send mail( 
'Your login link for Superlists', 
'body text tbc', 
'noreplyüsuperlists', 
[email], 


Tk Gk Gk Gk Gk 
— 


return redirect('/') 


在 不 真正 调用 send, mail 函数 的 情况 下 ， 应 该 怎么 测试 呢 ? 答案 是 在 调用 send login email 








注 1: 我 使 用 的 是 通用 术语 “ 双 件 ”(mock)， 而 测试 狂热 者 却 希望 明确 区 分 “测试 禁 身 ”这 类 测试 工具 中 
的 不 同 概念 ， 包 括 侦 件 (spy)、 伪 件 (fake) 和 桩 件 (stub)。 在 这 本 书 中 不 必 纠 结 它们 之 间 的 区 别 ， 
如 果 你 想 深 入 了 解 , 请 阅读 Justin Searls 写 的 精彩 维基 “Test Double”. MNE: 此 文 充满 各 种 测试 知识 。 
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视图 之 前 ， 测 试 可 以 让 Python 在 运行 时 把 send_mail 函数 替换 成 一 个 伪造 的 版 本 。 看 一 下 
具体 的 代码 : 





accounts/tests/test_views.py (ch171005) 


from django.test import TestCase 
import accounts.views 6 


class SendLoginEmailViewTest(TestCase): 


[e] 


def test sends mail to address from post(self): 
self.send mail called - False 


def fake send mail(subject, body, from email, to list): © 
self.send mail called - True 
self.subject - subject 
self.body - body 
self.from email - from email 
self.to list - to list 


accounts.views.send mail = fake send mail 6 


self.client.post('/accounts/send login email', data-( 
'email': 'edithQexample.com' 


I» 


self.assertTrue(self.send mail called) 
self.assertEqual(self.subject, 'Your login link for Superlists') 
self.assertEqual(self.from email, 'noreplyQsuperlists') 
self.assertEqual(self.to list, ['edithQexample.com']) 


@ X fake send mail 国 数 。 它 看 起 来 与 send_mait 函数 很 像 ， 但 它 其 实 只 是 使 用 self 
的 一 些 变量 存储 了 一 些 关 于 调用 方式 的 信息 。 
@ ”然后 ， 在 测试 执行 self.client.post 之 前 ， 把 真 的 accounts.views.send mail 国 数 换 
成 假 的 一 一 只 需 一 次 简单 的 赋值 。 
注意 ， 我 们 没有 施 什么 魔法 ， 只 是 打破 常规 ， 利 用 Python 这 门 动态 语言 的 优势 。 
在 真正 调用 函数 之 前 ， 只 要 命名 空间 正确 ， 就 可 以 修改 用 于 访问 函数 的 变量 (因此 才 需 
要 导入 位 于 顶层 的 accounts 模块 ， 这 样 方 能 进入 accounts.views 模块 ， 达 到 accounts. 
views.send login email 函数 所 在 的 作用 域 )。 
这 种 做 法 不 只 限于 单元 测试 ， 在 任何 Python 代码 中 都 可 以 像 这 样 打 猴子 补丁 。 
你 可 能 要 花 点 时 间 才 能 习惯 。 在 深入 探讨 细节 之 前 ， 你 要 说 服 自己 相信 这 没什么 大 不 
了 的 。 
。 为 什么 要 使 用 self 传递 信息 ?这 只 是 在 fake send mail 函数 的 作用 域内 外 传递 信息 的 
便利 方式 。 此 外 ， 我 们 还 可 以 使 用 可 变 的 对 象 ， 例 如 列表 或 字典 ， 只 要 那个 对 象 在 伪造 
函数 的 外 部 即 可 。( 如 果 好 奇 ， 可 以 试 试 不 同 的 方式 ， 看 哪些 可 行 ， 哪 些 不 可 行 。) 
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。 一 定 要 在 调用 真实 函数 “之 前 ”! SRMJCHCACRAEGORB, MEDERE, UTE BUE 
不 起 作用 呢 ? 最 后 才 憾 然 大 悟 ， 我 没有 在 调用 真实 的 函数 之 前 替换 为 伪造 的 函数 。 


罩 看 一 下 我 们 自己 动手 打造 的 驭 件 能 否 驱 动 开 发 : 


$ python manage.py test accounts 

Eseo] 
self.assertTrue(self.send_mail_called) 

AssertionError: False is not true 


直接 调用 send. mail 试 试 : 











下 














accounts/views.py 


def send login email(request): 
send mail() 
return redirect('/') 


测试 结果 变 成 了 : 
TypeError: fake send mail() missing 4 required positional arguments: 'subject', 
'body', 'from email', and 'to list' 
看 样子 猴子 补丁 起 作用 了 ! 我 们 调用 了 send_mail， 而 它 执行 的 是 fake send nail 函数 ， 
后 者 要 求 提供 更 多 参数 。 提 供 参 数 试 试 : 






































accounts/views.py 
def send login email(request): 
send mail('subject', 'body', 'from email', ['to email']) 
return redirect('/') 
测试 的 结果 为 : 
self.assertEqual(self.subject, 'Your login link for Superlists') 
AssertionError: 'subject' !- 'Your login link for Superlists' 
一 切 顺利 。 然 后 调整 代码 ， 改 成 下 面 这 样 : 
accounts/views.py 


def send login email(request): 
email = request.POST[ 'email'] 
send mail( 
'Your login link for Superlists', 
'body text tbc', 
'noreply(superlists', 
[email] 


return redirect('/') 
测试 能 通过 了 : 
$ python manage.py test accounts 
Ran 5 tests in 0.016s 


OK 





棒 极 
了 测 
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流行 


mock。 


T! 我 们 模拟 了 send_email 函数 ， 为 正常 情况 下 应 该 通过 互联 网 发 送 邮件 的 代码 编写 
试 ， 这 样 测试 和 代码 就 没有 出 入 了 。” 


.3 Python 的 模拟 库 


的 mock 包 从 Python 3.3 起 纳入 了 标准 库 。 这 个 包 提 供 了 一 个 充满 魔力 的 对 象 ， 名 为 
下 面 在 Python shell 中 试用 一 下 : 


>>> from unittest.mock import Mock 

>>> m = Mock() 

>>> m.any_attribute 

«Mock name='mock.any_attribute' id='140716305179152'> 
>>> type(m.any_attribute) 

«class 'unittest.mock.Mock'» 

>>> m.any method() 

«Mock namez'mock.any, method()' id-2'140716331211856'» 
>>> m.foo() 

«Mock namez'mock.foo()' id-'140716331251600'» 

>>> m.called 

False 

>>> m.foo.called 

True 

>>> m.bar.return value = 1 

>>> m.bar(42, varz'thing') 

1 

>>> m.bar.call args 

call(42, varz'thing') 














这 个 对 象 很 神奇 ， 它 能 响应 任何 属性 访问 或 方法 调用 ， 可 以 指明 调用 的 返回 值 ， 还 可 以 审 


查 调 


19. 


如 果 觉 
子 补 


稍 后 


用 时 传人 的 参数 是 什么 。 看 起 来 它 很 适合 在 单元 测试 中 使 用 。 


3.1 使 用 unittest.patch 


得 这 不 够 用 ，mock 模块 还 提供 了 辅助 函数 patch， 利 用 它 可 以 实现 前 面 动 手打 的 猴 
Js 


再 讲 原 理 ， 现 在 先 看 具体 用 法 : 
































accounts/tests/test views.py (ch171007) 


from django.test import TestCase 
from unittest.mock import patch 


[...] 


(Qpatch('accounts.views.send mail') 
def test sends mail to address from post(self, mock send mail): 
self.client.post('/accounts/send login email', data-( 





iE 2: 





iE 3: 


























是 的 ， 我 知道 Django 已 经 使 用 mail.outbox etik f E PHBH, (Bi, RAH, def EBORE. 
如 果 我 们 使 用 的 是 Flask 呢 ? 或 者 ， 如 果 这 是 调用 API， 而 不 是 发 送 邮件 呢 ? 
Python 2 用 户 可 以 使 用 pip install mock 安装 。 
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'email': 'edith(example.com' 


» 


self.assertEqual(mock send mail.called, True) 

(subject, body, from email, to list), kwargs - mock send mail.call args 
self.assertEqual(subject, 'Your login link for Superlists') 
self.assertEqual(from email, 'noreplyQsuperlists') 
self.assertEqual(to list, ['edithQexample.com']) 


重新 运行 这 个 测试 ， 你 会 发 现 它 仍 能 通过 。 大 改 之 后 依然 能 通过 的 测试 最 让 人 怀疑 ， 下 面 
故意 搞 个 破坏 : 


accounts/tests/test views.py (ch171008) 
self.assertEqual(to list, ['schmedithQexample.com']) 


并 在 视图 中 添加 一 行 代码 ， 打 印 调试 信息 : 





accounts/views.py (ch171009) 


def send login email(request): 
email = request.POST['email'] 
print(type(send mail)) 
send mail( 


fas] 


再 次 运行 测试 : 


显然 


FAN 


$ python manage.py test accounts 
[1 

«class 'function'» 

«class 'unittest.mock.MagicMock'» 


[555] 
AssertionError: Lists differ: ['edith(example.com'] !- 
['schmedithgexample.com'] 


Feal 
Ran 5 tests in 0.024s 
FAILED (failures=1) 


， 测 试 失败 了 。 从 失败 消息 前 面 的 输出 可 以 看 出 ，send_mail 函数 的 类 型 在 第 一 个 单 





元 测试 中 是 常规 的 函数 ， 而 在 第 二 个 单元 测试 中 则 是 一 个 驭 件 。 


删 掉 





意 出 错 的 代码 ， 然 后 深入 分 析 到 底 发 生 了 什么 : 


accounts/tests/test views.py (ch171011) 


(Qpatch('accounts.views.send mail') © 


def test sends mail to address from post(self, mock send mail): 6 
self.client.post('/accounts/send login email', data-( 
'email': 'edithQgexample.com' e 
n 


self.assertEqual(mock send mail.called, True) OQ 
(subject, body, from email, to list), kwargs = mock send mail.call args © 
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self.assertEqual(subject, 'Your login link for Superlists') 
self.assertEqual(from email, 'noreplyQsuperlists') 
self.assertEqual(to list, ['edithQexample.com']) 
@ patch 装饰 器 的 参数 是 要 打 猴 子 补 丁 的 国 数 的 点 分 名 称 。 这 一 行 代码 的 作用 等 同 于 动 
手 替 换 accounts.views 中 的 send mail 函数 。 这 个 装饰 器 的 优点 很 多 ， 不 仅 可 以 自动 
把 目标 替换 成 驱 件 ， 结 束 后 还 能 自动 换 回 原 对 象 (否则 后 续 使 用 的 仍 是 打 过 猴子 补丁 
的 版 本 ， 这 可 能 对 其 他 测试 产生 影响 )。 
@ patch 通过 传 给 测试 方法 的 参数 注入 驭 件 。 这 个 参数 的 名 称 随意 ， 不 过 我 习惯 在 原 对 
象 名 称 前 面 加 上 mock_。 
e “ 像 往 常 一 样 调用 要 测试 的 国 数 ， 但 是 在 测试 方法 中 使 用 的 是 驭 件 ， 所 以 视图 不 会 真 的 
调用 send_mail， 而 是 使 用 mock send mail, 
@ 下 断言 ， 检 查 双 件 在 测试 过 程 中 有 什么 变化 。 先 调用 双 件 …… 
O e 然后 拆 解 出 各 个 位 置 参数 和 关键 字 参 数 ， 检 查 调用 时 传人 的 是 什么 值 。( 稍 后 会 
详细 讨论 call args.) 
彻底 弄 明 白 了 吗 ? 没有 ? 没关系 。 后 面 还 会 在 多 个 测试 中 使 用 双 件 ， 你 会 逐渐 习惯 的 。 


19.3.2 ”让 测试 向 前 迈 一 小 步 
暂且 回 到 功能 测试 ， 看 看 是 在 哪里 失败 的 : 


$ python manage.py test functional tests.test login 


Ess] 
AssertionError: 'Check your email' not found in 'Superlists\nEnter email to log 
in:\nStart a new To-Do list' 


提交 电子 邮件 地 址 目前 没有 任何 效果 ， 因 为 表单 设 向 任何 地 方 发 送 数据 。 下 面 在 base.html 
中 设置 : * 
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H 




















lists/templates/base.html (ch171012) 


«form class-"navbar-form navbar-right" 
method="POST" 
action="{% url 'send login email' %}"> 
有 没有 用 ? 没有 ， 还 有 错误 。 为 什么 呢 ? 因为 成 功 给 用 户 发 送 电子 邮件 后 没有 显示 成 功 消 
息 。 下 面 为 此 添加 一 个 测试 。 














19.3.3 测试 Django 消 息 框架 


我 们 将 使 用 Django 的 “消息 框架 *， 通 常用 于 显示 临时 的 “成 功 ” 或 “提醒 ”消息 ， 指 明 
操作 的 结果 。 如 果 你 没 用 过 这 个 框架 ， 可 以 看 一 下 它 的 文档 。 

















注 4: 限于 本 书 纸张 的 尺寸 ， 我 把 这 个 form 标签 分 成 了 三 行 。 如 果 你 没 见 过 这 种 写法 ， 可 能 觉得 有 点 奇怪 ， 
但 这 是 有 效 的 HIML。 如 果 不 喜 欢 ， 你 可 以 不 这 样 写 。(@) 
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测试 Django 的 消息 有 点 曲折 ， 要 把 foLLow=True 传 给 测试 客户 端 ， 让 它 获 取 302 重 定向 后 
的 页 面 ， 在 里 面 查找 消息 列表 〈 在 显示 之 前 转换 为 列表 )。 这 个 测试 如 下 所 示 : 





accounts/tests/test views.py (ch171013) 


def test adds success message(self): 
response = self.client.post('/accounts/send login email', data={ 
'email': 'edithQexample.com' 
), follow-True) 


message = list(response.context['messages'])[0] 
self.assertEqual( 

message.message, 

"Check your email, we've sent you a link you can use to log in." 
) 


self.assertEqual(message.tags, "success" 
测试 的 结果 为 : 


$ python manage.py test accounts 
[41 

message = list(response.context['messages' ]) [0] 
IndexError: list index out of range 


然后 像 下 面 这 样 修改 ， 让 测试 通过 : 

















accounts/views.py (ch171014) 


from django.contrib import messages 


[555] 
def send login email(request): 
[x] 
messages.success( 
request, 


"Check your email, we've sent you a link you can use to log in." 


) 


return redirect('/') 





驭 件 可 能 导致 与 实现 紧密 耘 合 


这 个 框 注 涉及 中 级 测试 技巧 。 如 果 第 一 次 没 读 懂 ， 读 完 本 章 和 第 23 章 
之 后 再 回 过 头 来 看 。 


我 说 过 ， 测 试 消息 有 点 曲折 ， 我 试 了 好 几 次 才 做 对 。 其 实 ， 我 们 已 经 不 在 工作 中 这 样 
测试 消息 了 ， 而 是 使 用 驭 件 。 使 用 驭 件 的 话 ， 上 述 测试 可 以 改 成 这 样 : 











accounts/tests/test views.py (ch171014-2) 


from unittest.mock import patch, call 


[...] 


(Qpatch('accounts.views.messages') 
def test adds success message with mocks(self, mock messages): 
response = self.client.post('/accounts/send login email', data={ 
'email': 'edithQexample.com' 


I» 


expected - "Check your email, we've sent you a link you can use to log in." 
self.assertEqual( 

mock messages.success.call args, 

call(response.wsgi request, expected), 


) 


我 们 模拟 了 messages 模块 ， 然 后 检查 调用 messages.success 时 传 入 了 正确 的 参数 : m 
请 求 和 想 看 到 的 消息 。 


使 用 前 面 的 代码 就 能 让 这 个 测试 通过 。 不 过 有 个 问题 : 对 messages 框架 来 说 ， 获 得 相 
同 结果 的 方式 不 止 一 种 。 视 图 的 代码 还 可 以 像 这 样 写 : 


accounts/views.py (ch171014-3) 


messages.add message( 
request, 
messages.SUCCESS, 
"Check your email, we've sent you a link you can use to log in." 


) 


此 时 ,未 使 用 驭 件 的 测试 仍 能 通过 ， 但 使 用 驭 件 的 测试 将 失败 。 这 是 因为 没有 调用 
messages.success, 而 是 调用 了 messages.add_message。 即 便 最 终结 果 一 样 ， 而 且 代 码 
也 是 “正确 的 "， 可 测试 却 出 问题 了 。 

这 就 是 人 们 常 说 的 ， 使 用 驭 件 可 能 导致 “与 实现 紧密 耦合 "。 我 们 知道 ， 通 常 最 好 测 
试行 为 ， 而 不 测试 实现 细节 ; 测试 发 生 了 什么 ， 而 不 测试 是 如 何 发 生 的 。 驭 件 往往 在 
“如 何 做 ”这 条 道上 走 得 太 远 ,而 很 少 关 注 “ 是 什么 ”。 


后 续 章 节 还 会 深入 讨论 驭 件 的 优 续 点 。 








19.3.4 在 HTML 中 添加 消息 
HREM AHERE? 啊 ， 还 没有 。 我 们 要 把 消息 添加 到 页 面 中 ， 像 下 面 这 样 ， 





























lists/templates/base.html (chl 71015) 
NOI 


«[nav» 


(* if messages %} 
«div class="row"> 
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«div class-"col-md-8"» 
(* for message in messages %} 
{% if message.level tag == 'success' X) 
«div class-"alert alert-success"»([ message }}</div> 
(X else %} 
«div class-"alert alert-warning"»[([ message }}</div> 
{% endif 95) 
{% endfor %} 
</div> 
</div> 
{% endif %} 


现在 该 有 进展 了 吧 ? 是 的 ! 
$ python manage.py test accounts 


Dies] 
Ran 6 tests in 0.023s 


OK 
$ python manage.py test functional tests.test login 


[...] 


AssertionError: 'Use this link to log in' not found in 'body text tbc' 
失败 消息 提醒 我 们 ， 在 电子 邮件 的 正文 中 找 出 用 于 点 击 登录 的 链接 。 
先 上 暂时 作 兹 ， 直 接 修改 视图 中 的 值 : 























accounts/views.py 


send mail( 
'Your login link for Superlists', 
'Use this link to log in', 
'noreplyGsuperlists', 
[email] 


) 
样 ， 功 能 测试 稍微 向 前 走 了 一 点 : 


$ python manage.py test functional tests.test login 
[54 

AssertionError: Could not find url in email body: 
Use this link to log in 





bx 


19.3.5 构建 登录 URL 
接 下 来 该 构建 其 种 形式 的 URL f! xX—JKTIKERTESE. 





accounts/tests/test views.py (ch171017) 
class LoginViewTest(TestCase): 
def test redirects to home page(self): 


response = self.client.get('/accounts/login?token-abcd123') 
self.assertRedirects(response, '/') 





假设 令 牌 通过 GET 参数 传递 ， 即 放 在 ?后 面 。 现 在 还 不 需要 它 做 些 什么 











我 相信 你 能 构建 出 所 需 的 URL 和 视图 ， 在 这 个 过 程 中 你 会 历经 下 述 错误 。 

。 没有 URL: 
AssertionError: 404 !- 302 : Response didn't redirect as expected: Response 
code was 404 (expected 302) 

。 没有 视图 : 
AttributeError: module 'accounts.views' has no attribute 'login' 

bd 视图 出 错 : 


ValueError: The view accounts.views.login didn't return an HttpResponse object. 
It returned None instead. 


。 测试 通过 
$ python manage.py test accounts 
[2] 
Ran 7 tests in 0.029s 


OK 


现在 ， 链 接 的 目标 URL 有 了 ， 但 是 还 没什么 用 ， 因 为 我 们 还 没 给 用 户 提供 令 牌 。 


19.3.6 ”确认 给 用 户 发 送 了 带 有 令 牌 的 链接 
对 send login email 视图 来 说 ， 我 们 测试 了 电子 邮件 的 主题 、 发 件 地 址 和 收 件 地 址 ， 而 包 
含 令 牌 或 URL 的 正文 还 没有 测试 。 下 面 为 正文 编写 两 个 测试 : 





accounts/tests/test views.py (ch171021) 


from accounts.models import Token 


[...] 


def test creates token associated with email(self): 
self.client.post('/accounts/send login email', data-( 
'email': 'edithQexample.com' 
p) 
token = Token.objects.first() 
self.assertEqual(token.email, 'edith@example.com') 


@patch('accounts.views.send_mail') 
def test sends link to login using token uid(self, mock send mail): 
self.client.post('/accounts/send login email', data-( 
'email': 'edithQexample.com' 


}) 


token = Token.objects.first() 

expected url = f'http://testserver/accounts/login?token-(token.uid])' 
(subject, body, from email, to list), kwargs - mock send mail.call args 
self.assertIn(expected url, body) 
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第 一 个 测试 十 分 简单 ， 检 查 我 们 在 数据 库 中 创建 的 令 牌 是 与 POST 请 求 中 的 电子 邮件 地 址 
关联 的 。 

第 二 个 测试 是 我 们 第 二 次 使 用 驭 件 。 再 次 使 用 patch 装饰 器 模拟 sendmail 函数 ， 但 这 次 
关注 的 是 调用 时 传人 的 body 参数 。 














现在 ， 这 些 测 试 是 失败 的 ， 因 为 还 ESIE: 
$ python manage.py test accounts 
[1 
AttributeError: 'NoneType' object has no attribute 'email' 
[5.24 


AttributeError: 'NoneType' object has no attribute 'uid' 
创建 令 牌 就 能 让 第 一 个 测试 通过 : 
accounts/views.py (ch171022) 


from accounts.models import Token 


E 


def send login email(request): 
email = request.POST[ 'email'] 
token = Token.objects.create(email-email) 
send mail( 


[...] 
第 二 个 测试 提示 我 们 在 电子 邮件 的 正文 中 使 用 令 牌 ; 
I] 


AssertionError: 
'http://testserver/accounts/login?token-[...] 
not found in 'Use this link to log in' 











FAILED (failures-1) 


因此 ， 像 下 面 这 样 在 电子 邮件 中 插入 令 牌 : 














accounts/views.py (ch171023) 


from django.core.urlresolvers import reverse 


Ex 


def send login email(request): 
email = request.POST['email'] 
token = Token.objects.create(email-email) 
url = request.build absolute uri( © 
reverse('login') + '?token-' + str(token.uid) 


) 
message body = f'Use this link to log in:\n\n{url}' 
send mail( 
'Your login link for Superlists', 
message body, 
'noreply(superlists', 
[email] 
) 
[555] 





@ 请 注意 request.build_absolute_uri， 这 是 在 Django 中 构建 “完整 ”URL 的 一 种 方 
式 ， 所 得 的 URL 包括 域名 和 协议 (http/https)。 除 此 之 外 还 有 其 他 方式 ， 不 过 往往 都 
牵扯 “网 站 ”框架 ， 容 易 导 致 代码 过 于 复杂 。 如 果 你 好 奇 ， 简 单 搜索 一 下 就 能 找到 很 
多 这 方面 的 讨论 。 


我 们 又 解决 了 两 个 问题 。 接 下 来 ， 需 要 一 个 身份 验证 后 端 ， 检 查 令 牌 的 有 效 性 ， 然 后 返回 
对 应 的 用 户 。 此 外 ， 还 需要 让 登录 视图 在 用 户 通过 身份 验证 后 登入 用 户 。 


19.4 去 除 目 定义 的 身份 验证 后 端 中 的 探究 代码 
接 下 来 要 自 定义 身份 验证 后 端 。 探 究 时 编写 的 代码 如 下 所 示 : 


class PasswordlessAuthenticationBackend(object): 


























def authenticate(self, uid): 

print('uid', uid, file-sys.stderr) 

if not Token.objects.filter(uid-uid).exists(): 
print('no token found', file-sys.stderr) 
return None 

token = Token.objects.get(uid-uid) 

print('got token', file-sys.stderr) 

try: 
user - ListUser.objects.get(email-token.email) 
print('got user', file-sys.stderr) 
return user 

except ListUser.DoesNotExist: 
print('new user', file-sys.stderr) 
return ListUser.objects.create(email-token.email) 


def get user(self, email): 
return ListUser.objects.get(email-email) 


这 段 代码 的 意 AN 意思 是 : 


。 检查 数据 库 中 是 否 有 指定 的 UID; 
。 如 果 没 有 ， 返 回 None; 
。 如 果 有 ， 提 取 电 子 邮 件 地 址 ， 这 个 地 址 找到 现 有 的 用 户 ,或 者 创建 一 个 部 


19.4.1 一 个 if 语 名 需要 一 个 测试 


如 何 为 这 种 函数 编写 测试 有 个 经 验 法 则 : 一 个 if 语句 需要 一 个 测试 ,一 个 try/except 语 
句 也 需要 一 个 测试 。 所 以 这 里 一 共 需 要 三 个 测试 。 像 下 面 这 样 写 怎么 样 ? 








ng 
sk 
E 
X 














accounts/tests/test_authentication.py 


from django.test import TestCase 

from django.contrib.auth import get_user_model 

from accounts.authentication import PasswordlessAuthenticationBackend 
from accounts.models import Token 

User = get_user_model() 
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class AuthenticateTest(TestCase): 


def test returns None if no such token(self): 
result - PasswordlessAuthenticationBackend().authenticate( 
'no-such-token' 
) 


self.assertIsNone(result) 


def test returns new user with correct email if token exists(self): 
email = 'edithgexample.com' 
token = Token.objects.create(email-email) 
user - PasswordlessAuthenticationBackend().authenticate(token.uid) 
new user - User.objects.get(email-email) 
self.assertEqual(user, new user) 


def test returns existing user with correct email if token exists(self): 
email = 'edithgexample.com' 
existing user - User.objects.create(email-email) 
token = Token.objects.create(email-email) 
user - PasswordlessAuthenticationBackend().authenticate(token.uid) 
self.assertEqual(user, existing user) 


在 authenticate.py 中 人 先 放 一 个 占 位 函数 : 


accounts/authentication.py 


class PasswordlessAuthenticationBackend(object): 


def authenticate(self, uid): 
pass 

















测试 的 结果 如 何 ? 


$ python manage.py test accounts 


ERROR: test returns new user with correct email if token exists 
(accounts.tests.test authentication.AuthenticateTest) 
Traceback (most recent call last): 
File "/.../superlists/accounts/tests/test authentication.py", line 21, in 
test returns new user with correct email if token exists 
new user = User.objects.get(email-email) 


[...] 


accounts.models.DoesNotExist: User matching query does not exist. 


FAIL: test returns existing user with correct email if token exists 
(accounts.tests.test authentication.AuthenticateTest) 





Traceback (most recent call last): 
File "/.../superlists/accounts/tests/test authentication.py", line 30, in 
test returns existing user with correct email if token exists 
self.assertEqual(user, existing user) 
AssertionError: None !- «User: User object» 


Ran 12 tests in 0.038s 


FAILED (failures-1, errors-1) 


修改 代码 试 试 : 


accounts/authentication.py (ch171026) 


from accounts.models import User, Token 
class PasswordlessAuthenticationBackend(object): 
def authenticate(self, uid): 


token = Token.objects.get(uid-uid) 
return User.objects.get(email-token.email) 


一 个 测试 通过 了 ， 但 却 导 致 另 一 个 失败 了 : 














$ python manage.py test accounts 
ERROR: test returns None if no such token 
(accounts.tests.test authentication.AuthenticateTest) 


accounts.models.DoesNotExist: Token matching query does not exist. 


ERROR: test returns new user with correct email if token exists 
(accounts.tests.test authentication.AuthenticateTest) 
[...] 


accounts.models.DoesNotExist: User matching query does not exist. 


逐个 修正 : 


accounts/authentication.py (ch171027) 


def authenticate(self, uid): 
try: 
token = Token.objects.get(uid-uid) 
return User.objects.get(email-token.email) 
except Token.DoesNotExist: 
return None 


只 剩 一 个 失败 测试 了 : 


ERROR: test returns new user with correct email if token exists 
(accounts.tests.test authentication.AuthenticateTest) 
[2] 


accounts.models.DoesNotExist: User matching query does not exist. 


FAILED (errors-1) 
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这 个 问题 可 以 像 这 样 解决 : 





accounts/authentication.py (ch171028) 


def authenticate(self, uid): 

try: 

token = Token.objects.get(uid-uid) 

return User.objects.get(email-token.email) 
except User.DoesNotExist: 

return User.objects.create(email-token.email) 
except Token.DoesNotExist: 

return None 


这 比 探究 时 编写 的 代码 更 简洁 ! 


19.4.2 get_user 方 法 


我 们 已 经 实现 了 供 Django 用 于 登入 新 用 户 的 authenticate 函数 。 这 个 协议 的 第 二 部 分 是 
实现 get_user 方法 ， 它 的 作用 是 根据 唯一 标识 符 (电子 邮件 地 址 ) 获取 用 户 ， 如 果 找 不 到 
就 返回 None (如 果 你 记 不 清 了 ， 请 看 一 下 本 节 开 头 给 出 的 探究 代码 ) 。 


下 面 为 这 两 个 需求 编写 几 个 测试 : 




















accounts/tests/test authentication.py (ch171030) 


class GetUserTest(TestCase): 


def test gets user by email(self): 
User.objects.create(email-'another(jexample.com') 
desired user = User.objects.create(email-'edith(eexample.com') 
found user = PasswordlessAuthenticationBackend().get user( 
'edithgexample.com' 


) 


self.assertEqual(found user, desired user) 


def test returns None if no user with that email(self): 
self.assertIsNone( 
PasswordlessAuthenticationBackend().get user('edithQexample.com') 


) 
这 时 的 失败 消息 是 : 


AttributeError: 'PasswordlessAuthenticationBackend' object has no attribute 
'get user' 


那 就 定义 一 个 占 位 方法 ; 
accounts/authentication.py (ch171031) 
class PasswordlessAuthenticationBackend(object): 


def authenticate(self, uid): 


[2] 





def get user(self, email): 
pass 


现在 失败 消息 变 成 了 : 


self.assertEqual(found user, desired user) 
AssertionError: None !- «User: User object» 


慢 慢 实现 这 个 方法 (一步 一 步 来 ， 看 测试 是 否 像 我 们 设想 的 那样 失败 ): 





accounts/authentication.py (ch171033) 


def get user(self, email): 
return User.objects.first() 


现在 第 一 个 断言 通过 了 ， 失 败 消息 变 成 了 : 


self.assertEqual(found user, desired user) 
AssertionError: «User: User object» !- «User: User object» 


那 就 调用 get， 并 传人 电子 邮件 地 址 ; 








accounts/authentication.py (chl 71034) 


def get user(self, email): 
return User.objects.get(email-email) 


现在 针对 返回 None 的 测试 失败 了 : 


ERROR: test returns None if no user with that email 


[55] 


accounts.models.DoesNotExist: User matching query does not exist. 


根据 提示 ， 可 以 这 样 完成 整个 方法 : 





accounts/authentication.py (chl 71035) 


def get user(self, email): 
try: 
return User.objects.get(email-email) 
except User.DoesNotExist: 
return None Q 


@ 这 里 可 以 使 用 pass， 国 数 默认 会 返回 None。 但 我 们 
"HH f NE-FHEZE JEU], MZEE None, 


现在 测试 能 通过 了 : 
OK 


至 此 ， 我 们 得 到 了 一 个 可 用 的 身份 验证 后 端 。 


19.4.3 ”在 登录 视图 中 使 用 自 定义 的 验证 后 端 
最 后 一 步 ， 在 登录 视图 中 使 用 这 个 后 端 。 首 先 ， 在 settings.py 中 添加 自 定 义 的 后 端 : 


望 它 明确 返回 None， 所 以 根据 


3 


















































使 用 驭 件 测试 外 部 依赖 或 减少 重复 | 273 


super lists/settings.py (ch171036) 


AUTH USER MODEL = 'accounts.User' 
AUTHENTICATION BACKENDS - [ 
'accounts.authentication.PasswordlessAuthenticationBackend', 


] 
[...] 
然后 编写 几 个 测试 ， 检 查 视图 的 行为 。 再 看 一 下 探究 时 编写 的 视 








N 











accounts/views.py 


def login(request): 
print('login view', file=sys.stderr) 
uid = request.GET.get('uid') 
user = auth.authenticate(uid-uid) 
if user is not None: 
auth.login(request, user) 
return redirect('/') 


视图 要 调用 django.contrib.auth.authenticate。 如 果 返 回 一 个 用 户 ， 再 调用 django.contrib. 
auth.Login。 





现在 应 该 阅读 Django 文档 中 对 身份 验证 的 说 明 ， 进 一 步 了 解 细 市 





19.5 ”使 用 驭 件 的 另 一 个 原因 : 减少 重复 


我 们 已 经 使 用 驭 件 测 试 了 外 部 依赖 ， 例 如 Django 发 送 电 子 邮件 的 功能 。 使 用 驭 件 的 主要 
原因 是 隔离 外 部 副作用 ， 这 里 是 想 避 免 在 测试 中 真 的 发 送 电子 邮件 。 

本 市 将 说 明 驭 件 的 另 一 种 用 法 。 此 时 ， 没 有 什么 副作用 需要 担心 ， 但 是 鉴于 一 些 原 因 ， 我 
11105 2828 HUI, 

如 果 不 使 用 驭 件 ， 测 试 登录 视图 要 检查 用 户 有 设 有 真 的 登入 ， 即 检查 在 正确 的 情况 下 有 没 
有 为 用 户 赋予 表明 已 通过 身份 验证 的 会 话 cookie, 

但 是 ， 我 们 自 定义 的 身份 验证 后 端 有 几 个 不 同 的 代码 执行 路 径 : 令 牌 无 效 时 返回 None, H 


户 存 在 时 返回 既 存 用 户 、 令 牌 有 效 但 用 户 不 存在 时 新 建 用 户 。 因 此 ， 为 了 全 面 测 试 这 个 视 
图 ， 要 分 别针 对 这 三 种 情况 编写 测试 。 



































如 果 能 有 效 减 少 测试 之 间 的 重复 ， 就 有 充分 的 理由 使 用 驭 件 。 这 是 避免 组 合 
爆炸 的 一 种 方式 。 
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此 外 ， 我 们 使 用 的 是 Django 的 auth.authenticate 函数 ， 而 没有 直接 调用 自己 的 代码 ， 这 
样 便于 以 后 添加 额外 的 后 端 。 

因此 ， 有 必要 考虑 这 里 的 实现 细 市 (与 “ 双 件 可 能 导致 与 实现 紧密 而 合 ” 框 注 中 所 述 的 相 
反 )， 而 使 用 驭 件 能 避免 在 多 个 测试 中 重复 编写 实现 方式 。 下 面 看 一 下 这 个 测试 应 该 怎样 
使 用 驭 件 编写 : 




















accounts/tests/test views.py (ch171037) 


from unittest.mock import patch, call 


[...] 


@patch('accounts.views.auth') © 
def test calls authenticate with uid from get request(self, mock auth): @ 
self.client.get('/accounts/login?token-abcd123') 
self.assertEqual( 
mock auth.authenticate.call args, 6 
call(uid-'abcd123') ©@ 
) 


@ ”我 们 期 望 在 views.py 中 使 用 django.contrib.auth 模块 ， 所 以 这 里 模拟 它 的 行为 。 注 意 ， 
这 里 模拟 的 不 是 一 个 函数 ， 而 是 整个 模块 ， 即 模拟 模块 中 的 全 部 国 数 (及 其 他 对 象 ) 。 

@ 与 之 前 一 样 ， 把 被 模拟 的 对 象 注 入 测试 方法 。 

© ”这 一 次 模拟 的 是 一 个 模块 ， 而 不 是 一 个 函数 。 所 以 ，call_args 不 能 在 mock auth 模 
块 上 检查 ， 而 要 在 mock_auth.authenticate 国 数 上 检查 。 因 为 驭 件 的 所 有 属性 都 是 驭 
件 ， 所 以 mock auth.authenticate 国 数 也 是 一 个 驭 件 。 由 此 可 以 看 出 ， 与 自己 动手 相 
比 ，mock 对 象 是 多 么 好 用 。 

@ ”这 一 次 没有 “ 拆 包 ”调用 参数 ， 而 是 使 用 更 简洁 的 call 国 数 ， 指 明 调用 时 应 该 传人 什 
么 参数 一 一 GET 请 求 中 的 令 牌 。( 参 见 下 述 框 注 。) 


















































关于 驭 件 的 call args 


了 驭 件 的 call args 属性 表示 调用 驭 件 时 传 入 的 位 置 参 数 和 关键 字 和 参数。 这 是 一 个 特殊 的 
“调用 ”对 象 类 型 ， 其 实 是 一 个 元 组 ， 内 容 为 (positional_args, keyword_args)。 其 中 
positional args 自身 也 是 一 个 元 组 ， 和 包含 各 个 位 置 参 数 ; 而 keyword args 是 个 字典 。 


>>> from unittest.mock import Mock, call 

>>> m = Mock() 

>>> m(42, 43, 'positional arg 3', key='val', thing=666) 
«Mock name-'mock()' id-'139909729163528'» 


>>> m.call args 
call(42, 43, 'positional arg 3', key='val', thing-666) 


>>> m.call args == ((42, 43, 'positional arg 3'), {'key': 'val', 'thing': 666]) 
True 

>>> m.call args == call(42, 43, 'positional arg 3', key='val', thing-666) 

True 
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所 以 ， 在 上 述 测试 中 还 可 以 这 么 写 : 


accounts/tests/test views.py 


self.assertEqual( 
mock auth.authenticate.call args, 
(G2, {'uid': 'abcd123']) 


) 

# 或 者 这 样 写 

args, kwargs = mock auth.authenticate.call args 
self.assertEqual(args, (,)) 
self.assertEqual(kwargs, {'uid': 'abcdi123') 


不 过 可 以 看 出 ， 使 用 call 8 EDUC RR. 








测试 是 什么 情况 呢 ? 第 一 个 错误 是 : 


$ python manage.py test accounts 

[x1 

AttributeError: «module 'accounts.views' from 
'J[...[superlists/accounts/views.py'» does not have the attribute 'auth' 


在 使 用 驭 件 的 测试 中 ， 第 一 个 失败 消息 经 常 是 module foo does not have 
the attribute bar。 这 个 消息 的 意思 是 ， 你 尝试 模拟 的 东西 在 目标 模块 中 还 
不 存在 (或 者 尚未 导入 ) 。 











导入 django.contrib.auth 后 ， 错 误会 


e 


accounts/views.py (ch171038) 


from django.contrib import auth, messages 


[5x] 
现在 的 错误 是 : 
AssertionError: None != call(uid-'abcd123') 


测试 指出 ， 视 图 根本 没有 调用 auth.authenticate 国 数 。 下 面 修正 ， 但 是 故意 做 错 ， 看 看 
效果 如 何 : 

















accounts/views.py (ch171039) 


def login(request): 
auth.authenticate('bang!') 
return redirect('/') 


调用 的 确实 是 bang! : 
$ python manage.py test accounts 
[4:5] 
AssertionError: call('bang!') !- call(uid-'abcdi123') 
[...] 


FAILED (failures-1) 























下 面 给 authenticate 提供 预期 的 参数 : 











accounts/views.py (ch171040) 


def login(request): 
auth.authenticate(uid-request.GET.get('token')) 
return redirect('/') 


现在 测试 通过 了 : 
$ python manage.py test accounts 
[x] 
Ran 15 tests in 0.041s 


OK 


19.5.1 jiu imt 


接 下 来 ， 要 检查 authenticate 函数 是 否 返 回 一 个 用 户 ， 供 auth. login tE. WRK TE 
这 样 编写 : 






































accounts/tests/test_views.py (ch171041) 


@patch('accounts.views.auth') © 
def test_calls_auth_login_with_user_if_there_is_one(self, mock_auth): 
response = self.client.get('/accounts/login?token=abcd123') 
self.assertEqual( 
mock auth.login.call args, @ 
call(response.wsgi request, mock auth.authenticate.return value) 6 


) 
@ ”还 是 模拟 contrib.auth 模块 。 
@ ”这 一 次 检查 auth. login 函数 的 调用 参数 。 


e ”检查 调用 的 参数 是 不 是 视图 收 到 的 请 求 对 象 ， 以 及 authenticate 函数 返回 的 “用 户 ” 
对 象 。 因 为 authenticate 也 是 驭 件 ， 所 以 可 以 使 用 特殊 的 return. value 属性 。 


de E ^x, 我 们 也 可 以 从 调用 的 原 驱 件 中 获得 返回 的 双 件 
副本 。 为 了 解释 清楚 ， 我 不 得 不 多 次 使 用 “ 双 件 ”这 个 词 。 下 面 在 控制 台中 演示 一 下 ,项 
望 能 帮助 你 理解 : 


>>> m = Mock() 

>>> thing = m() 

>>> thing 

«Mock name='mock()' id-'140652722034952'» 
>>> m.return value 

«Mock name-'mock()' id-'140652722034952'» 
>>> thing == m.return value 

True 


先 不 管 这 些 ， 我 们 想 知道 测试 的 结果 如 何 : 


$ python manage.py test accounts 


[...] 
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call(response.wsgi request, mock auth.authenticate.return value) 
AssertionError: None !- call(«WSGIRequest: GET '/accounts/login?t[...] 


显然 ， 测 试 指出 我 们 根本 没有 调用 auth.togin。 下 面 调用 它 。 这 一 次 还 是 故意 做 错 。 





accounts/views.py (ch171042) 


def login(request): 
auth.authenticate(uid-request.GET.get('token')) 
auth.login('ack!') 
return redirect('/') 


调用 的 确实 是 ack!: 


TypeError: login() missing 1 required positional argument: 'user' 
[$2] 

AssertionError: call('ack!') != call(«WSGIRequest: GET 

' /accounts/login?token-[...] 


RETE: 





下 











accounts/views.py (ch171043) 


def login(request): 
user = auth.authenticate(uid-request.GET.get('token')) 
auth.login(request, user) 
return redirect('/') 


这 一 次 得 到 了 意料 之 外 的 失败 : 


ERROR: test redirects to home page (accounts.tests.test views.LoginViewTest) 
[...] 


AttributeError: 'AnonymousUser' object has no attribute ' meta' 
这 是 因为 我 们 在 所 有 情况 下 都 调用 auth.Login， 从 而 导致 针对 重 定向 的 测试 〈 目 前 没有 模 


拟 auth.login) 出 问题 。 为 了 修正 这 个 问题 ， 我 们 要 添加 一 个 if (外 加 一 个 测试 )。 届 时 ， 
我 们 将 学 习 如 何在 类 一 级 上 打 补 丁 。 


19.5.2 ”在 类 一 级 上 打 补 丁 

我 们 还 要 编写 一 个 测试 ， 而 且 也 要 使 用 Gpatch(' accounts.views.auth') 装饰 ， 这 样 便 开 始 
出 现 重 复 了 。 根 据 “ 三 则 重 构 ” 原 则 ， 可 以 把 patch 装饰 器 移 到 类 一 级 上 。 这 样 ， 测 试 类 
中 的 每 一 个 测试 方法 都 将 模拟 accounts.views.auth。 不 过 ， 这 也 意味 着 之 前 针对 重 定向 的 
测试 也 要 注入 mock auth 变量 : 





























accounts/tests/test views.py (ch171044) 


(patch('accounts.views.auth') © 
class LoginViewTest(TestCase): 


def test redirects to home page(self, mock auth): 6 


[ss] 


def test calls authenticate with uid from get request(self, mock auth): © 





s] 


def test calls auth login with user if there is one(self, mock auth): © 


[55] 


def test does not login if user is not authenticated(self, mock auth): 
mock auth.authenticate.return value = None Q 
self.client.get('/accounts/login?token-abcd123') 
self.assertEqual(mock auth.login.called, False) 6 


把 patch 装饰 器 移 到 类 一 级 …… 

所 以 第 一 个 测试 方法 多 了 一 个 参数 …… 

而 且 可 以 删 掉 其 他 测试 上 的 装饰 器 。 

在 新 测试 中 ， 调 用 self.client.get 之 前 在 auth.authenticate WE EIZE return value, 
下 断言 ， 在 authenticate 返回 None 时 ， 不 应 该 调用 auth.login, 

现在 假 失 败 不 见 了 ， 得 到 了 意义 明确 的 预期 失败 : 


self.assertEqual(mock auth.login.called, False) 
AssertionError: True !- False 


像 这 样 调整 视图 ， 让 测试 通过 : 




















© © © © © 








accounts/views.py (ch171045) 


def login(request): 
user - auth.authenticate(uid-request.GET.get('token')) 
if user: 
auth.login(request, user) 
return redirect('/') 


可 以 收工 了 吗 ? 


Ab mil IE Ab > 
19.6 ”关键 时 刻 : 功能 测试 能 通过 吗 
我 觉得 应 该 看 一 下 功能 测试 结果 如 何 了 。 
下 面 修改 基 模板 ， 为 已 登录 用 户 和 未 登录 用 户 显示 不 同 的 导航 栏 (功能 测试 检查 的 就 是 这 个 ) ; 




















7 











lists/templates/base.html (chl 71046) 


<nav class="navbar navbar-default" role="navigation"> 
<div class="container-fluid"> 
<a class="navbar-brand" href="/">Superlists</a> 
{% if user.email %} 
<ul class="nav navbar-nav navbar-right"> 
<li class="navbar-text">Logged in as {{ user.email }}</li> 
<li><a href="#">Log out</a></li> 
</ul> 
{% else %} 
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«form class-"navbar-form navbar-right" 
method="POST" 
action="{% url 'send login email' %}"> 
«span»Enter email to log in:«/span» 
«input class-"form-control" name-"email" type="text" /> 
{% csrf token %} 
</form> 
{% endif %} 
</div> 
</nav> 


看 看 测试 能 否 通过 : 


$ python manage.py test functional tests.test login 
Internal Server Error: /accounts/login 


EEA 
File "/.../superlists/accounts/views.py", line 31, in login 
auth.login(request, user) 


Es] 


ValueError: The following fields do not exist in this model or are m2m fields: 
last login 


[s] 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: Log out 


UR, 不! 出 问题 了 。 如 果 settings.py 中 还 保留 着 前 面 设 定 的 LoGGING， 你 应 该 会 看 到 如 上 所 
示 的 详细 调用 跟踪 。 可 以 看 出 ， 问 题 与 Last_Login 字段 有 关 。 

我 觉得 这 是 Django 的 缺陷 ， 可 验证 框架 就 是 预期 用 户 模型 有 个 Last_togin 字段 ， 而 我 们 
的 用 户 模 型 没有 。 不 过 ， 别 害怕 ! 解决 方法 总 是 有 的 。 
先 写 一 个 单元 测试 重 现 这 个 缺陷 。 因 为 这 与 我 们 自 定义 的 用 户 模 型 有 关 ， 所 以 放 在 test_ 
models.py 中 比较 合适 : 














accounts/tests/test models.py (ch171047) 


from django.test import TestCase 
from django.contrib import auth 
from accounts.models import Token 
User - auth.get user model() 


class UserModelTest(TestCase): 


def test user is valid with email only(self): 


[2553 
def test email is primary key(self): 
[s] 


def test no problem with auth login(self): 
user = User.objects.create(email-'edith(example.com') 
user.backend - '' 
request - self.client.request().wsgi request 
auth.login(request, user) # 不 该 抛 出 异常 





创建 一 个 请 求 对 象 和 一 个 用 户 ， 然 后 把 它们 传 给 auth. login 函数 。 
这 个 测试 会 向 我 们 报告 错误 : 
auth.login(request, user) # 不 该 抛 出 异常 
[...] 


ValueError: The following fields do not exist in this model or are m2m fields: 
last login 


这 个 缺陷 的 具体 原因 其 实 跟 本 书 没 有 多 大 关系 ， 如 果 你 想 追 根 究 底 ， 可 以 看 一 下 调用 跟踪 
中 给 出 的 那儿 行 Django 源码 ， 再 读 一 下 Django 文档 中 对 信号 的 说 明 。 


重点 是 ， 我 们 可 以 像 这 样 修正 : 


















































accounts/models.py (ch171048) 


import uuid 
from django.contrib import auth 
from django.db import models 


auth.signals.user logged in.disconnect(auth.models.update last login) 


class User(models.Model): 


[d] 
现在 功能 测试 的 结果 如 何 了 ? 


$ python manage.py test functional tests.test login 


[o] 


Ran 1 test in 3.282s 


OK 


* re — 
19.7 理论 上 正常 ， 那 么 实际 呢 
哇 鸣 1 你 能 相信 吗 ? 我 简直 不 能 相信 ! 下 面 执行 runserver 命令 ， 亲自 检查 一 下 : 


$ python manage.py runserver 
Ex 
Internal Server Error: /accounts/send_login email 
Traceback (most recent call last): 
File "/.../superlists/accounts/views.py", line 20, in send login email 














M 





ConnectionRefusedError: [Errno 111] Connection refused 
自己 动手 检查 时 ， 你 可 能 会 像 我 一 样 遇 到 一 个 错误 。 可 能 的 解决 方法 有 两 个 。 


* 在 settings.py 中 重新 配置 电子 邮件 。 
。 可 能 要 在 shell 中 导出 电子 邮件 的 密码 。 
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super lists/settings.py (ch171049) 


EMAIL HOST = 'smtp.gmail.com' 

EMAIL HOST USER = 'obeythetestinggoat(jgmail.com' 
EMAIL HOST PASSWORD - os.environ.get('EMAIL PASSWORD') 
EMAIL PORT - 587 

EMAIL USE TLS - True 


以 及 : 


$ export EMAIL PASSWORD-"sekrit" 
$ python manage.py runserver 


然后 便 能 看 到 如 图 19-1 所 示 的 界面 。 


























To-Do lists - Mozilla Firefox x 
To-Do lists X Gb 
(e ) © | localhost:8000 € | [Q Search |e oo $4) o0z 
Superlists Enter email to log in: 


Check your email, we've sent you a link you can use to log in. 


Start a new To-Do list 


Enter a to-do item 





图 1 


9-1; 查看 你 的 邮件 …… 


太 棒 了 ! 
在 此 之 前 我 一 直 没 提交 ， 因 为 我 在 等 待 一 切 都 能 顺利 运行 的 时 刻 。 此 时 ， 你 可 以 做 一 系列 


«nd 





和 独 的 提交 








登录 视图 一 次 、 验 证 后 端 一 次 、 用 户 模 型 一 次 、 修 改 模板 一 次 。 或 者 ， 考 





虑 到 这 些 代 码 都 有 关联 ， 不 能 独自 运行 ， 也 可 以 做 一 次 大 提交 : 


$ git status 

$ git add . 

$ git diff --staged 

$ git commit -m "Custom passwordless auth backend + custom user model" 








19.8 完善 功能 测试 ， 测 试 退出 功能 
收工 之 前 还 有 最 后 一 件 事 要 做 : 测试 退出 链接 。 在 现 有 功能 测试 的 基础 上 添加 几 步 . 


这 样 修改 之 后 








functional tests/test login.py (ch171050) 


[55] 
# 她 登录 了 | 
self.wait for( 
lambda: self.browser.find element by link text('Log out') 
) 


navbar = self.browser.find element by css selector('.navbar') 
self.assertIn(TEST EMAIL, navbar.text) 








# 现在 她 要 退出 
self.browser.find element by link text('Log out').click() 


* 她 退出 了 
self.wait for( 
lambda: self.browser.find element by name('email') 





) 


navbar = self.browser.find element by css selector('.navbar') 
self.assertNotIn(TEST EMAIL, navbar.text) 


， 测 试 会 失败 ， 原 因 是 退出 按钮 没 起 作用 : 














$ python manage.py test functional tests.test login 


[o] 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 


element: 


[namez"email"] 














实现 退出 按钮 的 方法 其 实 很 简单 : 可 以 使 用 Django 内 置 的 退出 视图 ， 让 它 清空 用 户 的 会 
话 ， 然 后 重 定向 到 我 们 指定 的 页 面 。 








accounts/urls.py (ch17105 1) 


from django.contrib.auth.views import logout 


Lors 


urlpatterns - [ 
url(r'^send login email$', views.send login email, name-'send login email'), 
url(r'^login$', views.login, name-'login'), 
url(r'^logout$', logout, ('next page': '/'), name-'logout'), 


] 


然后 在 base.html 中 ， 让 退出 按钮 指向 一 个 真 的 URL : 


lists/templates/base.html (ch171052) 


<li><a href="{% url 'logout' %}">Log out«/a»«/li» 
现在 ， 功 能 测试 都 能 通过 了 。 其 实 ， 整 个 测试 组 件 都 可 以 通过 


$ python manage.py test functional tests.test login 





[oc] 
OK 
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下 一 


$ python manage.py test 
gaa 
Ran 59 tests in 78.124s 


OK 





我 们 离 真 正安 全 或 可 行 的 登录 系统 还 远 着 呢 ! 这 只 是 一 本 书 的 示例 应 用 ， 可 
以 就 此 结束 。 但 是 在 实际 使 用 中 ， 你 得 研究 很 多 安全 和 可 用 性 问题 ， 要 做 的 
事 还 多 着 呢 ! 这 里 ， 我 们 以 身 犯 险 ,“ 自 己 动手 实现 加 密 ” 一 一 其 实 依赖 现 
有 的 登录 系统 将 安全 得 多 。 

















章 将 充分 利用 这 个 登录 系统 。 现 在 ， 做 次 提交 ， 然 后 阅读 总 结 。 








在 Python 中 使 用 模拟 技术 
模拟 技术 和 外 部 依赖 
编写 单元 测试 时 ， 如 果 涉 及 外 部 依赖 ， 但 又 不 想 在 测试 中 真 的 使 用 那个 依赖 ， 就 可 
以 使 用 模拟 技术 。 双 件 用 于 模拟 第 三 方 API。 虽 然 在 Python 中 可 以 自己 创建 驭 件 ， 
但 模拟 框架 (例如 mock 模块 ) 可 以 提供 很 多 便利 ， 让 编写 测试 变 得 更 简单 。 更 重 
要 的 是 ， 能 让 测试 读 起 来 更 顺口 。 
打 猴 子 补 丁 
在 运行 时 替换 某 个 命名 空间 中 的 对 象 。 前 面 的 单元 测试 使 用 驭 件 (通过 patch 装饰 
器 ) 替代 有 额外 副作用 的 真实 函数 。 
Mock Æ 
Michael Foord (在 我 加 入 PythonAnywhere 之 前 ， 他 在 孕育 PythonAnywhere 的 公司 
工作 ) 开发 了 很 优秀 的 Mock Æ, MEINE LARARE] Python 3 的 标准 库 中 。 这 
个 库 包含 了 在 Python 中 使 用 模拟 技术 所 需 的 几乎 全 部 功能 。 


patch 装饰 器 

unittest.mock 模块 提供 的 patch 函数 可 用 于 模拟 要 测试 的 模块 中 的 任何 一 个 对 
象 。patch 一 般 用 来 装饰 测试 方法 ， 不 过 也 可 以 放 在 类 一 级 ， 应 用 到 类 中 的 所 有 
测试 方法 上 。 

了 驭 件 可 能 导致 与 实现 紧密 耦合 

如 前 文 的 旁 注 所 述 ， 驭 件 可 能 导致 与 实现 紧密 耦合 。 鉴 于 此 ， 除 非 有 足够 的 理由 ， 
否则 不 应 该 使 用 驭 件 。 

驭 件 能 减少 测试 中 的 重复 

而 另 一 方面 ， 在 测试 中 又 没 必 要 重复 编写 使 用 某 个 函数 的 高 层级 代码 。 此 时 使 用 驭 
件 能 减少 重复 。 


接 下 来 还 将 更 为 深入 地 讨论 驭 件 的 优 缺点 。 效 请 期 待 ! 
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li B PRU — I RS AR VIDES 





有 了 一 个 可 以 使 用 的 认证 系统 ， 现 在 使 用 这 个 系统 来 识别 用 户 ， 展 示 用 户 创建 的 所 有 
清单 。 

为 此 ， 要 在 功能 测试 中 使 用 已 经 登录 的 用 户 对 象 。 但 不 能 每 个 测试 都 走 一 遍 发 送 登录 邮件 
过 程 ， 这 么 做 浪费 时 间 ， 所 以 跳 过 这 一 步 。 

这 就 是 分 离 关 注 点 。 功 能 测试 和 单元 测试 的 区 别 在 于 ， 前 者 往往 不 止 有 一 个 断言 。 但 是 ， 
理论 上 一 个 测试 只 应 该 测试 一 件 事 ， 所 以 没 必要 在 每 个 功能 测试 中 都 测试 登录 和 退出 功能 。 
如 果 能 找到 一 种 方法 “ 作 次 *"， 跳 过 认证 ， 就 不 用 花 时 间 等 待 执 行 完 重复 的 测试 路 径 了 。 








在 功能 测试 中 去 除 重复 时 不 要 做 得 过 火 了 。 功 能 测试 的 优势 之 一 是 ， 可 以 捕 
获 应 用 不 同 部 分 之 间 交 互 时 产生 的 神秘 莫 测 的 表现 。 











本 章 专 为 这 一 版 重 写 了 。 如 果 遇 到 问题 ， 或 者 有 改进 建议 ， 请 通过 
obeythetestinggoat ? gmail.com 告诉 我 。 





20.1 事先 创建 好 会 话 ， 跳 过 登录 过 程 


用 户 再 次 访问 网 站 时 cookie 依然 存在 ， 这 种 现象 很 常见 。 也 就 是 说 ， 之 前 用 户 已 经 通过 认 
证 了 。 所 以 这 种 “作弊 ”手段 并 非 异 想 天 开 。 有 具体 的 做 法 如 下 : 
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functional tests/test my lists.py 


from django.conf import settings 

from django.contrib.auth import BACKEND SESSION KEY, SESSION KEY, get user model 
from django.contrib.sessions.backends.db import SessionStore 

from .base import FunctionalTest 

User - get user model() 


class MyListsTest(FunctionalTest): 


def create pre authenticated session(self, email): 

user = User.objects.create(email-email) 

session - SessionStore() 

session[SESSION KEY] = user.pk ©@ 

session[BACKEND SESSION KEY] = settings.AUTHENTICATION BACKENDS[0] 

session.save() 

34 为 了 设 定 cookie， 我 们 要 先 访问 网 站 

E 而 404 页 面 是 加 载 最 快 的 

self.browser.get(self.live server url + "/404 no such url/") 

self.browser.add cookie(dict( 
name-settings.SESSION COOKIE NAME, 
value-session.session key, @ 
pathz'/', 

) 


在 数据 库 中 创建 一 个 会 话 对 象 。 会 话 键 的 值 是 用 户 对 象 的 主键 ， 即 用 户 的 电子 邮件 
地 址 。 

然后 把 一 个 cookie 添加 到 浏览 器 中 ，cookie 的 值 和 服务 器 中 的 会 话 匹 配 。 这 样 再 次 访 
问 网 站 时 ， 服 务 器 就 能 识别 已 登录 的 用 户 。 





注意 ， 这 种 做 法 仅 在 使 用 LiveServerTestCase 时 才 有 效 ， 所 以 已 创建 的 User 和 Session 对 


象 只 


存在 于 测试 服务 器 的 数据 库 中 。 稍 后 修改 实现 的 方式 ， 让 这 个 测试 也 能 在 过 渡 服 务 器 








里 的 数据 库 中 运行 。 











Django 会 话 : 通过 cookie 告知 服务 器 ， 用 户 已 通过 身份 验证 


我 斗 胆 尝 试 说 明 Django 中 的 会 话 、cookie 和 身份 验证 。 

HTTP 是 无 状态 的 ， 服务器 需要 通过 某 种 方式 识别 每 次 请 求 是 哪个 客户 端 发 送 的 。IP 
地 址 可 以 共享 ， 因 此 常用 的 方案 是 为 每 个 客户 总 分 配 一 个 唯一 的 会 话 ID， 存 储 在 
cookie 中 ， 随 每 次 请 求 发 送 。 服 务 器 会 把 这 个 ID 存储 在 某 处 (默认 存储 在 数据 库 中 )， 
从 而 识别 请 求 是 哪个 客户 端 发 送 的 。 

在 开发 服务 器 中 登录 网 站 后 ， 如 果 愿 意 ， 可 以 自己 动手 查看 会 话 ID， 它 默认 存储 在 
sessionid 键 名 下 ， 如 图 20-1 所 示 。 
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To-Do lists - Mozilla Firefox r7 
File Edit View History Bookmarks Tools Help 


[E To-Do lists O H 
€ [& localhost:8000/# » Œ| | 图 Google a i 会 Xx 
Superlists Logged in as harryGmockmyid.com Log out ] 


Start a new 
To-Do list 


File J 四 Headers Cookies s Response Timings 


Network 









7 localh: 0 
bootstrap.min.css localhost:8000 
base.css localhost:8000 


Response cookies 
v csrftoken "UZIRIu3DHqRhzjgWzM2NN3kB8LxCqxQq" 


expires: "2015-02-25T11:17:25.000Z" 
include js login.persona.org path: "/" 





jquery.min.js code.jquery.com 







accounts.js localhost:8000 Request cookies 

listjs localhost:8000 js csrftoken "UZIRIU3DHqRhzjgWzM2NN3kB8LxCqxQq" 
communication iframe login.persona.org html sessionid "Bu0pygdy9blo69693n40078ygt6l8y0y" 
session context login.persona.org json 





All HTML JS XHR Fonts Images Media Flash 
O- x 


四 
s 














& 20-1: 在 调试 工具 中 查看 会 话 cookie 

Django 网 站 会 为 所 有 访客 设 定 会 话 cookie， 不 管 有 没有 登录 。 

为 了 识别 已 登录 的 用 户 〈 即 通过 身份 验证 ) ， 服 务 器 不 会 让 客户 痛 每 次 请 求 都 发 送 用 户 
名 和 密码 ， 而 是 把 客户 篇 的 会 话 标记 为 已 通过 验证 的 会 话 ， 并 把 它 与 数据 库 中 的 用 户 
ID 关联 起 来 。 

会 话 是 类 似 字典 的 数据 结构 ， 用 户 ID 存储 在 django.contrib.auth.SESSION_KEY 设 定 
的 键 名 下 。 如 果 想 查看 会 话 的 值 ， 可 以 打开 ./manage.py shell; 


$ python manage.py shell 
[x] 


In [1]: from django.contrib.sessions.models import Session 


# 替换 成 你 浏览 器 cookie 中 的 会 话 ID 
In [2]: session = Session.objects.get( 

session key-"8uO0pygdy9blo696g3n40078ygt618y0y" 
) 


In [3]: print(session.get decoded()) 
('.auth user id': 'obeythetestinggoat(gmail.com', ' auth user backend': 
'accounts.authentication.PasswordlessAuthenticationBackend']) 


你 还 可 以 在 用 户 的 会 话 中 存储 其 他 信息 ， 作 为 一 种 临时 跟踪 状态 的 方式 。 这 对 未 登录 
的 用 户 也 是 有 效 的 。 如 果 想 这 么 做 ， 只 需 在 任意 视图 中 使 用 request.session， 它 与 字 
典 的 操作 方式 一 样 。 详 情 参 见 Django 文档 对 会 话 的 说 明 。 
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检查 是 否 可 行 

要 检查 这 种 做 法 是 否 可 行 ， 我 们 要 使 用 现 有 测试 中 的 一 些 代 码 。 下 面 分 别 定义 两 个 方法 : 
wait to be logged in 和 wait_to_be_logged_out。 要 想 在 不 同 的 测试 中 访问 这 两 个 方法 ， 
要 把 它们 放 到 FunctionalTest 类 中 。 此 外 ， 我 们 还 得 稍微 修改 一 下 ， 让 它们 可 以 接收 任意 
的 电子 邮件 地 址 作为 参数 : 

















functional tests/base.py (ch181002) 


class FunctionalTest(StaticLliveServerTestCase): 


[...] 


def wait to be logged in(self, email): 
self.wait for( 
lambda: self.browser.find element by link text('Log out') 
) 
navbar = self.browser.find element by css selector('.navbar') 
self.assertIn(email, navbar.text) 


def wait to be logged out(self, email): 
self.wait for( 
lambda: self.browser.find element by name('email') 
) 
navbar = self.browser.find element by css selector('.navbar') 
self.assertNotIn(email, navbar.text) 


虽 ， 还 不 错 ， 但 我 不 太 喜 欢 这 里 重复 出 现 的 wait for 部 分 。 先 在 便签 上 记录 下 来 ， 稍 后 再 
修改 ， 让 这 两 个 辅助 方法 可 用 。 




















E 。 清理 base.py 中 的 wait for 部 分 











首先 ， 在 test login.py 中 使 用 它们 : 


functional tests/test login.py (ch181003) 
def test can get email link to log in(self): 


[5] 
# 她 登录 了 | 
self.wait to be logged in(email-TEST EMAIL) 


# 现在 她 要 退出 
self.browser.find element by link text('Log out').click() 








# 她 退出 了 
self.wait to be logged out(email-TEST EMAIL) 
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为 了 确认 我 们 没有 破坏 现 有 功能 ， 再 次 运行 登录 测试 : 
$ python manage.py test functional tests.test login 


[...] 
OK 


现在 可 以 为 “My Lists” 页 面 编 写 一 个 占 位 测试 ， 检 查 事先 创建 认证 会 话 的 做 法 是 否 可 行 
functional tests/test my lists.py (ch181004) 














def test logged in users lists are saved as my lists(self): 
email = 'edithQexample.com' 
self.browser.get(self.live server url) 
self.wait to be logged out(email) 











# 伊 迪 丝 是 已 登录 用 户 

self.create pre authenticated session(email) 
self.browser.get(self.live server url) 
self.wait to be logged in(email) 


测试 的 结果 为 : 


$ python manage.py test functional tests.test my lists 


[...] 
OK 


现在 是 提交 的 好 时 机 : 


$ git add functional tests 
$ git commit -m "test my lists: precreate sessions, move login checks into base" 

















JSON 格式 的 测试 固件 有 危害 


使 用 测试 数据 预先 填充 数据 库 的 过 程 ， 例 如 存储 User 对 象 及 其 相关 的 Session 对 象 ， 
叫 作 设置 “测试 固件 ” (test fixture), 


Django 原生 支持 把 数据 库 中 的 数据 保存 为 JSON 格式 (使 用 manage. py dumpdata 命令 ) 。 
如 果 在 TestCase 中 使 用 类 属性 fixtures， 运 行 测试 时 Django 会 自动 加 载 JSON 格式 
的 数据 。 


越 来 越 多 的 人 建议 不 要 使 用 JSON 格式 的 固件 。 如 果 修 改 了 模型 ， 这 种 固件 维护 起 来 
简直 就 像 焉 梦 一 般 。 此 外 ， 对 阅读 代码 的 人 来 说 ，JSON 固件 中 众多 的 属性 值 让 人 分 
不 清 哪些 是 对 所 测试 的 行为 至 关 重 要 的 ， 而 哪些 只 是 用 于 补 白 的 。 最 后 ， 即 便 从 一 开 
始 就 共用 固件 ， 迟 早 会 有 测试 需要 稍微 不 同 的 数据 ， 如 此 一 来 ， 为 了 区 分 开 ， 只 能 到 
处 复制 整个 固件 ， 从 而 导致 无 法 区 分 哪些 与 测 斌 有关， 哪些 只 是 恰巧 在 那儿 。 


通常 ， 直 接 使 用 Django ORM 加 载 数据 要 简单 得 多 。 如 果 模 型 中 的 字段 
太 多 ， 或 者 模型 之 间 有 关联 ， 即 使 使 用 ORM 也 有 点 烦琐 。 此 时 ， 可 以 
使 用 一 个 备 受 推崇 的 工具 ， 名 为 factory_boy。 
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20.0 显 式 等 待 辅助 方法 最 终 版 : wait 装 饰 器 





我 们 的 代码 多 次 用 到 装饰 器 。 下 面 我 们 要 自己 定义 一 个 ， 学 习 装 饰 喜 的 工作 原理 
首先 ， 我 们 要 想 好 装饰 器 的 作用 。 我 们 的 计划 是 ， 让 这 个 装饰 器 替代 wait 




















o 


for row in. 


list table 中 的 等 待 - 重 试 -超时 逻辑 ， 以 及 watt to be logged in/out 中 对 self.wait for 





的 调用 ， 就 像 这 样 : 


functional tests/base.py (ch181005) 


@wait 

def wait for row in list table(self, row text): 
table = self.browser.find element by id('id list table') 
rows - table.find elements by tag name('tr') 
self.assertIn(row text, [row.text for row in rows]) 


(wait 

def wait to be logged in(self, email): 
self.browser.find element by link text('Log out') 
navbar = self.browser.find element by css selector('.navbar') 
self.assertIn(email, navbar.text) 


(wait 

def wait to be logged out(self, email): 
self.browser.find element by name('email') 
navbar = self.browser.find element by css selector('.navbar') 
self.assertNotIn(email, navbar.text) 


























做 好 准备 了 吗 ? 装饰 器 难以 理解 (我 自己 花 了 好 长 时 间 才 理解 ， 而 且 每 次 自己 定义 时 都 要 
仔细 回想 ) ， 但 好 消息 是 我 们 在 self wait for 辅助 函数 中 已 经 接触 过 函数 式 编程 了 。 在 函 





























数 式 编 程 中 ， 我 们 把 一 个 函数 作为 参数 传 给 另 一 个 参数 ， 装 饰 器 也 是 这 个 道班 











不 同 之 处 在 于 ， 它 并 不 执行 代码 ， 而 是 返回 指定 函数 修改 后 的 版 本 。 


B, 装饰 器 的 


我 们 这 个 装饰 器 要 返回 一 个 新 函数 ， 它 不 断 调用 指定 的 函数 ， 并 捕获 常规 的 异常 ， 直 到 超 








时 为 止 。 下 面 是 首次 尝试 : 











functional tests/base.py (ch181006) 


def wait(fn): ©@ 
def modified fn(): © 
start time - time.time() 
while True: Q 
try: 
return fn() G9 
except (AssertionError, WebDriverException) as e: [4] 
if time.time() - start time » MAX WAIT: 
raise e 
time.sleep(0.5) 
return modified fn 6 


@ 装饰 器 的 作用 是 修改 函数 ， 其 参数 是 一 个 函数 …… 
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@ e 而 返回 的 则 是 修改 后 (或 “装饰 后 ”) 的 版 本 。 
e ”创建 函数 的 修改 版 。 
@ ”这 是 我 们 熟悉 的 循环 ， 它 一 直 运 行 着 ， 捕 获 常 规 的 异常 ， 直 到 超时 为 止 。 
Oo ”与 之 前 一 样 ， 如 果 没 有 异常 ， 立 即 调用 传 入 的 函数 ， 然 后 返回 。 
这 么 定义 基本 上 是 可 以 的 ,但 是 还 不 完全 正确 ， 不 信 运 行 测试 看 看 : 
$ 
[. 


















































python manage.py test functional tests.test my lists 
..] 
self.wait to be logged out(email) 
TypeError: modified fn() takes 0 positional arguments but 2 were given 


与 self.wait for 不 同 ， 这 个 装饰 器 依附 的 函数 是 有 参数 的 : 


functional tests/base.py 
(wait 
def wait to be logged in(self, email): 
self.browser.find element by link text('Log out') 


wait to be logged in 有 两 个 位 置 参 数 , 分 别 是 self 和 email。 但 是 , iiin modified fn 
之 后 ， 参 数 没有 了 。 我 们 应 该 怎么 做 才能 把 被 装饰 的 fn 的 参数 传 给 modified fn WE? 


答案 涉及 一 点 Python 魔法 ，*args 和 **kwargs, ， 即 人 们 熟知 的 “ 变 长 参数 ”( 我 也 是 刚 知 道 )。 


functional tests/base.py (ch181007) 


def wait(fn): 
def modified fn(*args, **kwargs): © 
start time - time.time() 
while True: 
try: 
return fn(*args, **kwargs) @ 
except (AssertionError, WebDriverException) as e: 
if time.time() - start time » MAX WAIT: 
raise e 
time.sleep(0.5) 
return modified fn 


@ 把 modified_fn 的 参数 设 为 *args 和 **kwargs, 以 此 指定 它 可 以 接受 任意 个 位 置 参数 和 
e ”在 函数 的 定义 中 指定 之 后 ， 还 要 把 它们 传 给 我 们 真正 要 调用 的 fn, 
通过 这 种 方式 还 可 以 让 装饰 器 修改 函数 的 参数 ， 但 是 这 里 不 展开 讨论 了 。 现 在 的 重点 是 ， 
装饰 器 可 用 了 : 

$ python manage.py test functional tests.test my lists 


[...] 
OK 











你 知道 真正 让 人 高 兴 的 是 什么 吗 ? self.wait for 辅助 函数 也 可 以 使 用 wait 装饰 器 了 ， 如 
下 所 示 : 
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functional tests/base.py (ch181008) 


(wait 
def wait for(self, fn): 
return fn() 


妙 啊 ! 现在 等 待 一 重 试 逻辑 封装 到 一 个 地 方 了 ， 而 且 还 可 以 灵活 设 定 等 待 ， 既 可 以 在 功能 
测试 内 部 调用 self.wait_for， 也 可 以 在 任何 辅助 函数 上 使 用 @wait 装饰 器 。 


下 一 章 将 把 代码 部 署 到 过 渡 服 务 器 上 ， 并 在 服务 器 上 使 用 预先 验证 身份 的 会 话 固件 。 你 将 
看 到 ， 这 个 过 程 能 帮 我 们 找 出 一 两 个 bug, 











。 装饰 器 很 棒 
通过 装饰 器 ， 可 以 抽象 不 同 层 次 的 关注 点 。 本 章 定义 的 装饰 器 可 以 让 测试 中 的 断言 
不 同时 等 待 。 

。 谨慎 去 除 功 能 测试 中 的 重复 
没 必要 让 每 个 功能 测试 都 测试 应 用 的 全 部 功能 。 在 这 一 章 遇 到 的 情况 中 ， 我 们 想 避 
免 在 每 个 需要 已 验证 身份 的 用 户 的 功能 测试 中 走 一 遍 整 个 登录 流程 ， 所 以 使 用 测试 
固件 “ 作 羟 "， 跳 过 登录 过 程 。 在 功能 测试 中 ， 还 可 能 需要 跳 过 其 他 过 程 。 不 过 ， 
我 要 提醒 一 下 ， 功 能 测试 的 目的 是 捕获 应 用 不 同 部 分 之 间 交 互 时 的 异常 表现 ， 所 以 
去 除 重 复 时 一 定 要 谨慎 ， 别 过 火 了 。 

。 测试 固件 
测试 固件 指 运 行 测试 之 前 要 提前 准备 好 的 测试 数据 ， 通 常 是 指使 用 一 些 数 据 填充 数 
据 库 。 不 过 如 前 所 示 (创建 浏览 器 的 cookie) ， 也 会 涉及 其 他 准备 工作 。 

。 避免 使 用 JSON 固件 
Django 提供 的 dumpdata 和 loaddata 等 命令 简化 了 把 数据 库 中 的 数据 导出 为 JSON 
格式 的 操作 ， 也 可 以 轻易 使 用 JSON 格式 的 数据 还 原 数 据 库 。 多 数 人 都 不 建议 使 
用 这 种 测试 固件 ， 因 为 数据 库 模 式 发 生变 化 后 这 种 固件 很 难 维护 。 请 使 用 Django 
ORM, Xf factory boy 这 类 工具 。 
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p21% 





服务 器 端 调 试 技术 


做 了 这 么 多 事 之 后 ， ee 我 们 定义 了 儿 个 用 于 等 待 的 辅助 函数 ， 它 们 有 
什么 用 呢 ? 哦 ， 是 等 待 用 户 登 录 的 。 那 用 户 是 如 何 登录 的 呢 ? 啊 ， 是 通过 预先 构建 已 验证 
身份 的 用 户 实现 的 。 


21.1 “实践 是 检验 真理 的 唯一 标准 : 在 过 渡 服 务 器 
中 捕获 最 后 的 问题 


个 功能 测试 在 本 地 运行 一 切 顺利 ， 但 在 过 渡 服 务 器 中 情况 如 何 呢 ? 部 署 网 站 试 一 下 。 在 
这 个 过 程 中 会 遇 到 一 个 意料 之 外 的 问题 (体现 了 过 渡 服 务 器 的 作用 )。 为 了 解决 这 个 问题 ， 
要 找到 在 测试 服务 器 中 管理 数据 库 的 方法 : 

$ cd deploy, tools 


$ fab deploy --host-elspethüsuperlists-staging.ottg.eu 
[.. M 


然后 重启 Gunicorn: 

















elspeth@server:$ sudo systemctl daemon-reload 
elspethüserver:$ sudo systemctl restart gunicorn-superlists-staging.ottg.eu 


运行 功能 测试 得 到 的 结果 如 下 : 
$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 


ERROR: test can get email link to log in 
(functional tests.test login.LoginTest) 
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Traceback (most recent call last): 
File "/.../functional tests/test login.py", line 22, in 
test can get email link to log in 
self.assertIn('Check your email', body.text) 
AssertionError: 'Check your email' not found in 'Server Error (500)' 


ERROR: test logged in users lists are saved as my lists 
(functional tests.test my lists.MyListsTest) 
Traceback (most recent call last): 
File "/home/harry/.../book-example/functional tests/test my lists.py", 
line 34, in test logged in users lists are saved as my lists 
self.wait to be logged in(email) 
File "/worskpace/functional tests/base.py", line 42, in wait to be logged in 
self.browser.find element by link text('Log out') 
[zs] 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: ("method":"link text","selector":"Log out") 
Stacktrace: 


[e] 


Ran 8 tests in 27.933s 


FAILED (errors=2) 





无 法 登录 ， 不 管 使 用 真实 的 电子 邮件 系统 还 是 使 用 已 经 通过 验证 的 会 话 都 不 行 。 看 样子 我 
们 全 新 打造 的 身份 验证 系统 把 服务 器 搞 月 涡 了 





PÉ 





i 使 用 服务 器 端 调试 技术 找 出 问题 所 在 。 








设 


置 日 志 


为 了 记录 这 个 问题 ， 配 置 Gunicorn， 让 它 记 录 日 志 。 在 服务 器 中 使 用 vi 或 nano 按照 下 面 
的 方式 调整 Gunicorn 的 配置 ; 


R 





server: /etc/systemd/system/gunicorn-superlists-staging.ottg.eu.service 


ExecStart-/home/elspeth/sites/superlists-staging.ottg.eu/virtualenv/bin/gunicorn V 
--bind unix:/tmp/superlists-staging.ottg.eu.socket V 
--capture-output V 
--access-logfile ../access.log V 
--error-logfile ../error.log V 
superlists.wsgi:application 


配置 之 后 ，Gunicorn 会 在 -/site/SSITENAME 文件 夹 中 保存 访问 日 志和 错误 日 志 。 











bx 


还 要 确保 settings.py 中 仍 有 LOGGING 设置 ， 这 样 调试 信息 才能 输送 到 终端 。 








superlists/settings.py 


LOGGING = ( 
'version': 1, 
'disable existing loggers': False, 
'handlers': { 
'console': ( 
'level': 'DEBUG', 


'class': 'logging.StreamHandler', 
b 
J 
'loggers': { 
'django': { 
'handlers': ['console'], 
b 
Js 


'root': {'level': 'INFO'}, 
} 


再 次 重启 Gunicormn， 然 后 运行 功能 测试 ， 或 者 手动 登录 试 试 。 在 这 些 操 作 执行 的 过 程 中 ， 
可 以 使 用 下 面 的 命令 监视 日 志 : 


elspeth@server:$ sudo systemctl daemon-reload 
elspethüserver:$ sudo systemctl restart gunicorn-superlists-staging.ottg.eu 
elspethüserver:$ tail -f error.log # 假设 位 于 -/sites/SSITENAME x (/- erp 


你 应 该 会 看 到 类 似 下 面 的 错误 : 


Internal Server Error: /accounts/send login email 
Traceback (most recent call last): 
File "/home/elspeth/sites/superlists-staging.ottg.eu/virtualenv/lib/python3.6/[...] 
response - wrapped callback(request, *callback args, **callback kwargs) 
File 
"[home/elspeth/sites/superlists-staging.ottg.eu/source/accounts/views.py", line 
20, in send login email 
[email] 
[...] 
self.connection.sendmail(from email, recipients, message.as_bytes(linesep=\r\n)) 
File "/usr/lib/python3.6/smtplib.py", line 862, in sendmail 
raise SMTPSenderRefused(code, resp, from addr) 
smtplib.SMTPSenderRefused: (530, b'5.5.1 Authentication Required. Learn more 
atVn5.5.1 https://support.google.com/mail/?p-WantAuthError [...] 
- gsmtp', noreplyQsuperlists) 


, Gmail 拒绝 发 送 电子 邮件 ， 是 吗 ? 可 那 是 为 什么 呢 ? 哦 ， 原 来 是 因为 我 们 疫 有 告诉 服 
MAE. 


21.2 在 服务 器 上 通过 环境 变量 设 定 机 密 信息 


第 11 章 讲 过 在 服务 器 上 设 定 机 密 信息 的 一 种 方式 ， 那 时 我 们 在 服务 器 的 文件 系统 中 创建 
了 一 个 一 次 性 的 Python 文件 ， 然 后 导入 ， 设 定 Django 的 SECRET. KEY 设置 。 


这 几 章 则 在 shell 中 使 用 环境 变量 存储 电子 邮件 的 密码 。 我 们 也 将 在 过 渡 服 务 器 上 使 用 这 种 
方式 。 可 以 在 Systemd 的 配置 文件 中 设 定 环境 变量 






































服务 器 端 调试 技术 | 295 


server: /etc/systemd/system/gunicorn-superlists-staging.ottg.eu.service 


[Service] 

Userzelspeth 

Environment-EMAIL PASSWORD-yoursekritpasswordhere 
WorkingDirectory-/home/elspeth/sites/superlists-staging.ottg.eu/source 


[...] 





在 安全 方面 ， 使 用 配置 文件 有 个 好 处 : 可 以 限制 权限 ， 只 让 root 用 户 可 读 。 
而 Python 源 文 件 做 不 到 这 一 点 。 








保存 这 个 文件 ， 然 后 执行 daemon-reload 和 restart gunicorn 命令 。 再 次 运行 功能 测试 ， 
结果 如 下 : 


$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 


[5] 
Traceback (most recent call last): 
File "/.../superlists/functional tests/test login.py", line 25, in 
test can get email link to log in 
email = mail.outbox[0] 
IndexError: list index out of range 


[x] 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: ("method":"link text","selector":"Log out") 


ny. lists 失败 没 变 ， 但 是 登录 测试 提供 了 更 多 信息 功能 测试 向 前 进 了 ， 网 站 看 起 来 能 
送 电 子 邮件 了 (服务 器 日 志 没 有 显示 错误 )， 但 是 在 mail.outbox 中 找 不 到 邮件 …… 


21.83 调整 功能 测试 ， 以 便 通 过 POP3 测 试 真实 
的 电子 邮件 


啊 ， 确 实 应 该 如 此 。 功 能 测试 现在 在 真实 的 服务 器 中 和 运行， 而 不 是 使 用 LiveServerTestCase， 
因此 我 们 不 能 再 检查 本 地 的 django. mail.outbox 中 有 没有 发 出 的 邮件 了 。 


首先 ， 在 功能 测试 中 要 想 办 法 判断 是 不 是 运行 在 过 渡 服 务 器 中 。 在 base.py 中 ， 把 staging server 
变量 绑 定 到 self E: 

















functional tests/base.py (ch181009) 


def setUp(self): 
self.browser = webdriver.Firefox() 
self.staging server - os.environ.get('STAGING SERVER') 
if self.staging server: 
self.live server url = 'http://' + self.staging server 








然后 ， 构 建 一 个 辅助 函数 ， 使 用 Python 标准 库 中 极其 难 用 的 POP3 客户 端 从 真实 的 POP3 
电子 邮件 服务 器 中 获取 真实 的 电子 邮件 : 




















functional tests/test login.py (ch181010) 


import os 
import poplib 
import re 
import time 


[...] 


def wait for email(self, test email, subject): 
if not self.staging server: 
email - mail.outbox[0] 
self.assertIn(test email, email.to) 
self.assertEqual(email.subject, subject) 
return email.body 


email id - None 
start - time.time() 
inbox = poplib.POP3 SSL('pop.mail.yahoo.com') 
try: 
inbox.user(test email) 
inbox.pass (os.environ['YAHOO PASSWORD']) 
while time.time() - start « 60: 
# 获取 最 新 的 16 封 邮件 
count,  - inbox.stat() 
for i in reversed(range(max(1, count - 10), count + 1)): 
print('getting msg', i) 
., lines, | = inbox.retr(i) 
lines = [l.decode('utf8') for l in lines] 
print(lines) 
if f'Subject: {subject}' in lines: 
email id - i 
body = 'An'.join(lines) 
return body 
time.sleep(5) 
finally: 
if email id: 
inbox.dele(email id) 
inbox.quit() 





测试 时 我 使 用 的 是 Yahoo 账户 ， 你 可 以 使 用 任何 电子 邮件 服务 ， 只 要 支持 通 
过 POP3 访问 即 可 。 你 要 在 运行 功能 测试 的 控制 台中 设 定 YAHOO, PASSWORD 环 
境 变 量 


3 











接 下 来 调整 功能 测试 中 其 他 需要 改动 的 地 方 。 首 先 ， 针 对 本 地 环境 和 过 渡 服 务 器 为 test 
email 变量 设 定 不 同 的 值 : 
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然后 


functional tests/test login.py (ch181011-1) 


@@ -7,7 +7,7 @@ from selenium.webdriver.common.keys import Keys 
from .base import FunctionalTest 
-TEST EMAIL = 'edith(example.com' 


A 
SUBJECT = 'Your login link for Superlists' 


QQ -33,7 +33,6 QQ class LoginTest(FunctionalTest): 
print('getting msg', i) 


., lines, | = inbox.retr(i) 
lines = [l.decode('utf8') for l in lines] 
- print(lines) 


if f'Subject: {subject}' in lines: 
email id = i 
body = 'An'.join(lines) 
QQ -49,6 448,11 QQ class LoginTest(FunctionalTest): 
# 伊 迪 丝 访问 这 个 很 棒 的 超级 列表 网 站 
# 第 一 次 注意 到 导航 栏 中 有 “登录 ”区 域 
# 看 到 要 求 输 入 电子 邮件 地 址 ， 她 便 输入 了 
































+ if self.staging server: 
* test email = 'edith.testuser(yahoo.com' 
* else: 
十 test email = 'edith@example.com' 
十 
self.browser.get(self.live server url) 
使 用 那个 变量 ， 并 调用 新 定义 的 辅助 函数 : 





functional tests/test login.py (ch181011-2) 


QQ -54,7 +54,7 QQ class LoginTest(FunctionalTest): 
test email = 'edith(example.com' 


self.browser.get(self.live server url) 
- self.browser.find element by name('email').send keys(TEST EMAIL) 
* self.browser.find element by name('email').send keys(test email) 
self.browser.find element by name('email').send keys(Keys.ENTER) 























# 出 现 一 个 消息 ， 告 诉 她 邮件 已 经 发 
QQ -64,15 +64,13 QQ class LoginTest(FunctionalTest): 
» 


# 她 查看 邮件 ， 看 到 一 个 消息 
- email = mail.outbox[0] 
- self.assertIn(TEST EMAIL, email.to) 
- self.assertEqual(email.subject, SUBJECT) 
* body = self.wait for email(test email, SUBJECT) 


# 邮件 中 有 个 URL 链 接 
- self.assertIn('Use this link to log in', email.body) 
- url search = re.search(r'http://.*/.*$', email.body) 





LL 

















* self.assertIn('Use this link to log in', body) 
* url search = re.search(r'http://.*/.4$', body) 
if not url search: 
- self.fail(f'Could not find url in email body:\n{email.body}') 
* self.fail(f'Could not find url in email body:\n{body}') 
url = url search.group(0) 
self.assertIn(self.live server url, url) 


@@ -80,11 478,11 @@ class LoginTest(FunctionalTest): 
self.browser.get(url) 


# 她 登录 了 1 
- self.wait to be logged in(email-TEST EMAIL) 
* self.wait to be logged in(email-test email) 


# 现在 她 要 退出 
self.browser.find element by link text('Log out').click() 











# 她 退出 了 
self.wait to be logged out(email-TEST EMAIL) 
十 self.wait to be logged out(email-test email) 


不 管 你 信 不 信 ， 这 样 改动 之 后 就 行 了 。 经 功能 测试 确认 ， 登 录 功 能 可 以 正常 使 用 了 一 一 我 
们 可 是 发 送 了 真实 的 电子 邮件 啊 ! 

















我 费 了 好 大 劲 才 凑 出 了 检查 电子 邮件 的 代码 ， 目 前 还 不 雅 观 ， 有 点 脆弱 C 
见 的 问题 是 错误 沿用 上 一 次 测试 的 电子 邮件 )。 如 果 能 整理 一 下 ， 再 多 试 试 ， 
我 想 代码 会 更 可 靠 。 如 果 不 想 这 么 麻烦 ， 可 以 使 用 mailinator.com 这 样 的 服 
务 ， 只 需 少 量 费用 就 能 获得 一 个 一 次 性 的 电子 邮件 地 址 和 查看 邮件 的 API。 


21.4 在 过 渡 服 务 器 中 管理 测试 数据 库 


现在 可 以 再 次 运行 功能 测试 ， 此 时 又 会 看 到 一 个 失败 测试 ， 因 为 无 法 创建 已 经 通过 认证 的 
会 话 ， 所 以 针对 “My Lists” 页 面 的 测试 失败 了 : 


$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 















































ERROR: test logged in users lists are saved as my lists 

(functional tests.test my lists.MyListsTest) 

[e] 

selenium.common.exceptions.TimeoutException: Message: Could not find element 
with id id logout. Page text was: 

Superlists 

Sign in 

Start a new To-Do list 


Ran 8 tests in 72.742s 


FAILED (errors-1) 
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失败 的 真正 原因 是 create pre authenticated session 国 数 只 能 操作 本 地 数据 库 。 我 们 要 
找到 一 种 方法 ， 管 理 服务 器 中 的 数据 库 。 


21.4.1 创建 会 话 的 Django 管 理 命令 

若 想 在 服务 器 中 操作 ， 就 要 编写 一 个 自 成 一 体 的 脚本 ， 在 服务 器 中 的 命令 行 里 运行 。 大 多 
数 情况 下 都 会 使 用 Fabric 执行 这 样 的 脚本 。 

尝试 编写 可 在 Django 环境 中 运行 的 独立 脚本 (和 数据 库 交 互 等 )， 有 些 问 题 要 谨慎 处 理 ， 
例如 正确 设 定 DJANGO SETTINGS MODULE 环境 变量 ， 还 要 正确 处 理 sys.path, 



























































我 们 可 不 想 在 这 些 细节 上 浪费 时 间 。 其 实 Django 允许 我 们 自己 创建 “管理 命令 ”( 可 以 使 
用 python manage.py 运行 的 命令 ) ， 可 以 把 一 切 琐碎 的 事情 都 交 给 Django 完成 。 管 理 命令 





保存 在 应 用 的 management/commands 文件 夹 中 : 





$ mkdir -p functional tests/management/commands 
$ touch functional tests/management/ init  .py 
$ touch functional tests/management/commands/. init  .py 


里 命令 的 样板 代码 是 一 个 类 ， 继 承 自 django.core.management.BaseCommand, mo H. X T 
一 个 名 为 handle 的 方法 : 


管 


MH 





functional tests/management/commands/create session.py 


from django.conf import settings 

from django.contrib.auth import BACKEND SESSION KEY, SESSION KEY, get user model 
User - get user model() 

from django.contrib.sessions.backends.db import SessionStore 

from django.core.management.base import BaseCommand 


class Command(BaseCommand): 


def add arguments(self, parser): 
parser.add argument('email') 


def handle(self, *args, **options): 
session key - create pre authenticated session(options['email']) 
self.stdout.write(session key) 


def create pre authenticated session(email): 
user = User.objects.create(email-email) 
session - SessionStore() 
session[SESSION KEY] - user.pk 
session[BACKEND SESSION KEY] = settings.AUTHENTICATION BACKENDS[0] 
session.save() 
return session.session key 





create pre authenticated session 国 数 的 代码 从 test. my. lists.py 文件 中 提取 而 来 。handle 
方法 从 选项 中 获取 电子 邮件 地 址 ， 返 回 一 个 将 要 存 入 浏览 器 cookie 中 的 会 话 键 。 这 个 管理 
命令 还 会 把 会 话 键 打 印 到 命令 行 中 。 试 一 下 这 个 命令 : 








E 
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$ python manage.py create session a@b.com 
Unknown command: 'create session' 


还 要 做 一 步 设 置 一 一 把 functional tests 加 入 settings.py, ik Django 把 它 识 别 为 一 个 可 能 
包含 管理 命令 和 测试 的 真正 应 用 : 

















superlists/settings.py 


+++ b/superlists/settings.py 

@@ -42,6 +42,7 @@ INSTALLED APPS = [ 
'lists', 
'accounts', 

* 'functional tests', 


现在 这 理 命 令 可 以 使 用 了 : 


$ python manage.py create session a(b.com 
qnslckvp2aga7tm6xuivybOobiakzzwl 


如 果 报 错 说 缺少 auth user 表 ， 可 能 就 要 执行 manage.py migrate 命令 。 如 果 
还 不 行 ， 重 新 来 过 ， 删 除 db.sqlite3， 再 执行 migrate 命令 





21.4.2 ”让 功能 测试 在 服务 器 上 运行 管理 命令 


接 下 来 调整 test my. lists.py 文件 中 的 测试 ， 让 它 在 本 地 服务 器 中 运行 本 地 函数 ， 但 是 在 过 
渡 服 务 器 中 运行 管理 命令 : 




















functional tests/test my lists.py (ch181016) 


from django.conf import settings 

from .base import FunctionalTest 

from .server tools import create session on server 

from .management.commands.create session import create pre authenticated session 


class MyListsTest(FunctionalTest): 


def create pre authenticated session(self, email): 
if self.staging server: 
session key - create session on server(self.staging server, email) 
else: 
session key = create pre authenticated session(email) 
## 为 了 设 定 cookie， 我 们 要 先 访问 网 站 
检 而 404 页 面 是 加 载 最 快 的 
self.browser.get(self.live server url + "/404 no such url/") 
self.browser.add cookie(dict( 
name-settings.SESSION COOKIE NAME, 
value-session key, 
pathz'/', 
)) 


[d 
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此 外 ， 还 要 调整 base.py， 当 处 在 过 渡 服 务 器 中 时 ， 提 供 更 多 信息 : 


functional tests/base.py (ch181017) 


from .server tools import reset database © 


I] 


class FunctionalTest(StaticLliveServerTestCase): 


def setUp(self): 
self.browser = webdriver.Firefox() 
self.staging server - os.environ.get('STAGING SERVER') 
if self.staging server: 
self.live server url = 'http://' + self.staging server 
reset database(self.staging server) © 


@ 这 个 国 数 的 作用 是 在 两 次 测试 之 间 还 原 服务 器 中 的 数据 库 。 稍 后 我 会 讲解 创建 会 话 这 
段 代 码 的 逻辑 ， 以 及 为 什么 可 以 这 么 做 。 


21.4.3 ”直接 在 Python 代码 中 使 用 Fabric 


除了 fab 命令 之 外 ，Fabric 还 提供 了 API， 这 样 便 可 以 直接 在 Python 代码 中 执行 Fabric 服 
务 器 命令 。 为 此 ， 只 需 通 过 一 个 字符 串 告 诉 Fabric 你 想 连 接 的 主机 即 可 : 














functional tests/server tools.py 


from fabric.api import run 
from fabric.context managers import settings 


def get manage dot py(host): 
return f'-/sites/(host)/virtualenv/bin/python -/sites/[host)/source/manage.py' 


def reset database(host): 
manage dot py = | get manage dot py(host) 
with settings(host string-f'elspethQü[host]'): © 
run(f'(manage dot py) flush --noinput') 6 


def create session on server(host, email): 
manage dot py = | get manage dot py(host) 
with settings(host string-f'elspethQ([host)]'): © 
session key = run(f'[manage dot py) create session {email}') @ 
return session key.strip() 


0 这 个 上 下 文 管理 器 设 定 主机 字符 串 ， 格 式 为 user@server-address (我 直接 把 自己 的 服 
务 器 用 户 名 elspeth 写 进 去 了 , 别 忘 了 修改 )。 


e ”在 上 下 文中 可 以 像 在 fabfile 中 那样 直接 调用 Fabric 命令 。 
































^ = 
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21.4.4 回顾 : 在 本 地 服务 器 和 过 渡 服 务 器 中 创建 会 话 的 方式 


充分 理解 了 吗 ? 下 面 通过 ASCII 图 表 回 顾 一 














eI... + 4eI--2-----.-22.--- 十 
| MyListsTest | --> | .management.commands.create session | 
| .create pre authenticated session | | .create pre authenticated session | 
| (locally) | | (locally) 
4e... + e + 

2. 在 过 渡 服务 器 中 
r2... + 4eI--1--.2.--- + 
| MyListsTest | | .management.commands.create session | 
| .create pre authenticated session | | .create pre authenticated session | 
| (locally) | | (on server) 
4rI--2-1-1-..-2-2--- + e + 

| ^ 

M | 
+- + +-------- + 4e... + 
| server_tools | --> | fabric | --» | ./manage.py create session | 
| .create session on server | | "run" | | (on server) 
| (locally) | +-------- 十 + + 
+---------------------------- + 





不 论 如 何 ， 看 一 下 这 么 做 是 否 可 行 。 首 先 ， 在 本 地 运行 测试 ， 确 认 没 有 造成 任何 破坏 : 


$ python manage.py test functional tests.test my lists 


[...] 
OK 


然后 在 服务 器 中 运行 。 先 把 代码 推送 到 服务 器 中 : 


$ git push # 要 先 提交 改动 
$ cd deploy_tools 
$ fab deploy --host=superlists-staging.ottg.eu 


再 运行 测试 : 


$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test V 
functional tests.test my lists 

[5.5] 

[superlists-staging.ottg.eu] Executing task 'reset database' 

^[sites/superlists-staging.ottg.eu/source/manage.py flush --noinput 
[superlists-staging.ottg.eu] out: Syncing... 
[superlists-staging.ottg.eu] out: Creating tables ... 


[225] 





Ran 1 test in 25.701s 


OK 


看 起 来 没 问 题 。 还 可 以 运行 全 部 测试 确认 一 下 : 
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$ STAGING SERVERssuperlists-staging.ottg.eu python manage.py test V 
functional tests 

[s] 

[superlists-staging.ottg.eu] Executing task 'reset_database' 

[s] 

Ran 8 tests in 89.494s 


OK 


太 棒 了 ! 











我 展示 了 管理 测试 数据 库 的 一 种 方法 ， 你 也 可 以 试验 其 他 方式 。 例 如 ， 使 用 
MySQL 或 Postgres， 可 以 打开 一 个 SSH 隧道 连接 服务 器 ， 使 用 端口 转发 直 
接 操作 数据 库 。 然 后 修改 settings .DATABASES， 让 功能 测试 使 用 隧道 连接 的 
端口 和 数据 库 交 互 。 























警告 : 小 心 ， 不 要 在 线 上 服务 器 中 运行 测试 
我 们 现在 遇 到 一 件 危 险 的 事 ， 因 为 编写 的 代码 能 直接 影响 服务 器 中 的 数据 库 。 一 定 要 
非常 非常 小 心 ， 别 在 错误 的 主机 中 运行 功能 测试 ， 把 生产 数据 库 清 空 了 。 


此 时 ， 可 以 考虑 使 用 一 些 安全 防护 措施 。 例 如 ， 把 过 渡 环 境 和 生产 环境 放 在 不 同 的 服 
务 器 中 ， 而 且 不 同 的 服务 器 使 用 不 同 的 口令 认证 密 钥 对 。 


在 生产 环境 的 数据 副本 中 运行 测试 也 有 同样 的 危险 ， 我 就 曾经 不 小 心 重复 给 客户 发 送 
了 发 票 ( 见 附录 D)。 这 是 前 车 之 鉴 啊 。 


21.5 集成 日 志 相关 的 代码 


结束 本 章 之 前 ， 我 们 要 把 日 志 相 关 的 代码 集成 到 应 用 中 。 把 输出 日 志 的 代码 放 在 那儿 ， 并 
且 纳 入 版 本 控制 ， 有 助 于 调试 以 后 遇 到 的 登录 问题 。 毕 竞 有 些 人 不 怀 好 意 。 


先 把 Gunicorn 的 配置 保存 到 deploy. tools 文件 夹 里 的 临时 文件 中 : 











deploy tools/gunicorn-systemd.template.service (ch181020) 


[x] 
Environment-EMAIL PASSWORD-SEKRIT 
ExecStart-/home/elspeth/sites/SITENAME/virtualenv/bin/gunicorn V 
--bind unix:/tmp/SITENAME.socket V 
--access-logfile ../access.log V 
--error-logfile ../error.log V 
superlists.wsgi:application 


[...] 


然后 在 配置 笔记 中 加 上 儿 点 ， 提 醒 自 己 别 忘 了 在 Gunicorn 配置 文件 中 设 定 电子 邮件 密码 的 


环境 变量 ， 
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deploy tools/provisioning notes.md (ch181021) 
## Systemd 服 务 


* 参见 gunicorn-systemd.tempLate.service 

* 把 SITENAME 杰 换 成 有 具体 的 域名 ， 例 如 staging.my-domain.com 
* 把 SEKRIT 楚 换 成 电子 邮件 密码 

[...] 


21.6 ”小结 
在 服务 器 中 运行 新 代码 总 会 让 一 些 缺 陷 和 意料 之 外 的 问题 显露 出 来 。 为 了 解决 这 些 问 题 
我 们 做 了 很 多 工作 ， 不 过 在 这 个 过 程 中 也 收获 颇 多 。 
我 们 定义 了 通用 的 wait 装饰 器 ， 这 更 符合 Python 习惯 ， 在 功能 测试 中 到 处 都 可 以 使 用 。 
我 们 让 测试 固件 既 可 以 在 本 地 使 用 ， 也 能 在 服务 器 中 使 用 (包括 对 “真实 ”电子 邮件 的 
测试 )。 此 外 ， 还 设 定 了 更 牢靠 的 日 志 配 置 。 

不 过 ， 在 部 署 线 上 网 站 之 前 ， 最 好 为 用 户 提 供 他 们 真正 想 要 的 功能 
“My Lists” 页 面 中 汇总 用 户 的 清单 。 


























下 一 章 介 绍 如 何在 








在 过 渡 服务 器 中 捕获 缺陷 时 学 到 的 知识 

。 固件 也 要 在 远程 服务 器 中 使 用 
在 本 地 运行 测试 ， 使 用 LiveServerTestCase 即 可 以 轻松 通过 Django ORM 与 测试 数 
据 库 交互 。 与 过 渡 服 务 器 中 的 数据 库 交 互 就 没 这 么 简单 了 。 解 决 方法 之 一 是 使 用 
Django 管理 命令 ， 如 前 文 所 示 。 不 过 也 可 以 小 心 探索 ， 找 到 适合 自己 的 方法 。 

。 在 服务 器 中 重 置 数据 时 要 格外 小 心 
能 远程 清除 服务 器 中 整个 数据 库 的 命令 极其 危险 ， 一 定 要 小 心 再 小 心 ， 确 保 不 会 意 
外 损坏 生产 数据 。 

。 日 志 对 调试 服务 器 中 的 问题 非常 重要 
你 至 少 要 能 看 到 服务 器 产生 的 错误 消息 。 对 较为 环 手 的 缺陷 来 说 ， 还 要 能 得 到 临时 
的 “调试 输出 ”， 保 存在 某 个 文件 中 。 
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完成 “My Lists” 页 面 ， 由 外 而 内 
的 TDD 


本 章 我 要 介绍 一 种 技术 ， 叫 “由 外 而 内 ”的 TDD。 一 直 以 来 ,我 们 几乎 都 在 使 用 这 种 技 
A. 双 循 环 ”TDD 流程 就 体现 了 由 外 而 内 的 思想 一 一 先 编写 功能 测试 ， 然 后 再 编写 单元 
测试 ， 其 实 就 是 从 外 部 设计 系统 ， 再 分 层 编 写 代码 。 现 在 我 要 明确 提出 这 个 概念 ， 再 讨论 
其 中 涉及 的 常见 问题 。 


22.1 对 立 技术 : “由 内 而 外 ” 


“由 外 而 内 ”的 对 立 技术 是 “由 内 而 外 ”， 接 触 TDD 之 前 ， 大 多 数 人 都 赁 直觉 选择 后 者 。 
提出 一 个 设计 想法 之 后 ， 有 了 时 会 自然 而 然 地 从 最 内 部 、 最 低层 的 组 件 开 始 实 现 。 

例如 ， 就 我 们 现在 面临 的 问题 而 言 ， 要 想 为 用 户 提供 一 个 “My Lists” 页 面 显示 已 经 保存 
的 清单 ， 我 们 首先 会 迫不及待 地 在 List 模型 中 添加 owner 属性 ， 因 为 根据 需求 推断 ， 显 
然 需 要 这 样 一 个 属性 。 之 后 ， 借 助 这 个 新 属性 修改 外 层 代 码 ， 例 如 视图 和 模板 ， 最 后 添加 
URL 路 由 ， 指 向 新 视图 。 


这 么 做 感觉 更 自然 ， 因 为 所 用 的 代码 从 来 不 会 依赖 尚未 实现 的 功能 。 内 层 的 一 切 都 是 构建 
外 层 的 坚实 基础 。 


不 过 ， 像 这 样 由 内 而 外 的 工作 方式 也 有 缺点 。 
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22.2 为 什么 选择 使 用 “由 外 而 内 ” 


由 内 而 外 的 技术 最 明显 的 问题 是 它 迫 使 我 们 抛 开 TDD 流程 。 功 能 测试 第 一 次 失败 可 能 是 
因为 缺少 URL 路 由 ， 但 我 们 决定 忽略 这 一 点 ， 先 为 数据 库 模 型 对 象 添加 属性 。 

我 们 可 能 已 经 在 脑海 中 构思 好 了 内 层 的 模样 ， 而 且 这 些 想法 往往 都 很 好 ， 不 过 这 些 都 是 对 

真实 需求 的 推测 ， 因 为 还 未 构造 使 用 内 层 组 件 的 外 层 组 件 。 

这 么 做 可 能 会 导致 内 层 组 件 太 党 统 ， 或 者 比 真 实 需求 功能 更 强 一 不仅 浪费 了 时 间 ， 还 把 
项 目 变 得 更 为 复杂 。 另 一 种 常见 的 问题 是 ， 创 建 内 层 组 件 使 用 的 API 乍 看 起 来 对 内 部 设计 
言 很 合适 ， 但 之 后 会 发 现 并 不 适用 于 外 层 组 件 。 更 糟 的 是 ， 最 后 你 可 能 会 发 现 内 层 组 件 
完全 无 法 解决 外 层 组 件 需 要 解决 的 问题 。 

与 此 相反 ， 使 用 由 外 而 内 的 工作 方式 ， 可 以 在 外 层 组 件 的 基础 上 构思 想 从 内 层 组 件 获取 的 
最 佳 API。 下 面 以 实例 说 明 如 何 使 用 由 外 而 内 技术 。 


22.3 “My Lists” 页 面 的 功能 测试 
编写 下 面 这 个 功能 测试 时 ， 我 们 从 能 接触 到 的 最 外 层 开 始 (表现 
(或 叫 “ 控 制 器 ”)， 最 后 是 最 内 层 ， 在 这 个 例子 中 是 模型 代码 。 


既然 create pre authenticated session 图 数 可 以 正常 使 用 ， 那 么 就 可 以 直接 用 来 编写 针 
对 “My Lists” 页 面 的 功能 测试 : 









































)， 然 后 是 视图 函数 








mn 








functional tests/test my lists.py (ch191001-1) 


def test logged in users lists are saved as my lists(self): 
# 伊 迪 丝 是 已 登录 用 户 
self.create pre authenticated session('edithQexample.com') 


# 她 访问 首页 ， 新 建 一 个 清单 
self.browser.get(self.live server url) 
self.add list item('Reticulate splines') 
self.add list item('Immanentize eschaton') 
first list url = self.browser.current url 


# 她 第 一 次 看 到 My Lists 链 接 
self.browser.find element by link text('My lists').click() 


# 她 看 到 这 个 页 面 中 有 她 创建 的 清单 
# 而 且 清 单 根据 第 一 个 待 办 事项 命名 
self.wait for( 

lambda: self.browser.find element by link text('Reticulate splines') 
) 
self.browser.find element by link text('Reticulate splines').click() 
self.wait for( 

lambda: self.assertEqual(self.browser.current url, first list url) 


) 


先 创建 一 个 包含 儿 个 待 办 事项 的 清单 ， 然 后 检查 这 个 列表 会 出 现在 新 的 “My Lists" UU 
上 ,而 且 以 清单 中 的 第 一 个 待 办 事项 命名 。 
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接着 前 面 的 单元 测试 ， 再 创建 一 个 清单 ， 确 保 的 确 会 出 现在 “My Lists” 页 面 上 。 与 此 同 
时 ， 再 检查 只 有 已 登录 的 用 户 才能 看 到 “My Lists” 页 面 : 











functional tests/test my lists.py (ch191001-2) 
] 


self.wait_for( 
lambda: self.assertEqual(self.browser.current url, first list url) 


) 
# 她 决定 再 建 一 个 清单 试 试 


self.browser.get(self.live server url) 
self.add list item('Click cows') 
second list url = self.browser.current url 




















* (p "My Lists” 页 面 ， 这 个 新 建 的 清单 也 显示 出 来 了 
self.browser.find element by link text('My lists').click() 
self.wait for( 

lambda: self.browser.find element by link text('Click cows') 











) 
self.browser.find element by link text('Click cows').click() 
self.wait for( 
lambda: self.assertEqual(self.browser.current url, second list url) 


) 


# 她 退出 后 ，“My Lists” 链 接 不 见 了 

self.browser.find element by link text('Log out').click() 

self.wait for(lambda: self.assertEqual( 
self.browser.find elements by link text('My lists'), 


[] 





)) 


上 述 功能 测试 使 用 了 一 个 新 的 辅助 方法 ， 即 add_list_item， 它 抽象 了 在 正确 的 输入 框 中 
输入 文本 的 操作 。 这 个 辅助 方法 在 base.py 中 定义 : 











functional tests/base.py (ch191001-3) 


from selenium.webdriver.common.keys import Keys 


pss] 


def add list item(self, item text): 
num rows = len(self.browser.find elements by css selector('£id list table tr')) 
self.get item input box().send keys(item text) 
self.get item input box().send keys(Keys.ENTER) 
item number = num rows + 1 
self.wait for row in list table(f'[item number): [item text]') 


定义 好 这 个 辅助 方法 之 后 ， 可 以 在 其 他 功能 测试 中 像 下 面 这 样 使 用 : 




















functional tests/test list item. validation.py 





self.add list item('Buy wellies') 


我 觉得 使 用 这 个 辅助 方法 之 后 ， 功 能 测试 的 可 读 性 提高 了 不 少 。 我 改 了 6 处 ， 看 看 你 是 否 
与 我 一 样 。 


























运行 全 部 功能 测试 ， 做 个 提交 ， 然 后 回 到 我 们 正在 处 理 的 这 个 功能 测试 。 你 看 到 的 第 一 个 
错误 应 该 是 这 样 的 : 


$ python3 manage.py test functional tests.test my lists 


EN 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: My lists 


22.4 外 层 : 表现 层 和 模板 


目前 ， 这 个 测试 失败 ， 报 错 无 法 找到 “My Lists” 链 接 。 这 个 问题 可 以 在 表现 层 ， 即 base.html 
Pose. 中 解决 。 最 少量 的 代码 改动 如 下 所 示 : 




















lists/templates/base.html (ch191002- 1) 


(* if user.email X) 

«ul class="nav navbar-nav navbar-left"> 
<li><a href="#">My lists«/a»«/li» 

</ul> 

<ul class="nav navbar-nav navbar-right"> 
<li class="navbar-text">Logged in as {{ user.email }}</li> 
<li><a href="{% url 'logout' %}">Log out</a></li> 

</ul> 


显然 ， 这 个 链接 没 指向 任何 页 面 ， 不 过 却 能 解决 这 个 问题 ， 得 到 下 一 个 失败 消息 : 


$ python3 manage.py test functional tests.test my lists 
[5s 














lambda: self.browser.find element by link text('Reticulate splines') 


NE 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: Reticulate splines 


失败 消息 指出 要 构建 一 个 页 面 ， 用 标题 丈 
一 个 URL 和 一 个 占 位 模板 。 


可 以 再 次 使 用 由 外 而 内 技术 ， 先 从 表现 层 开 始 ， 只 写 上 地 址 ， 其 他 什么 都 不 做 : 


lists/templates/base.html (ch191002-2) 





出 一 个 用 户 的 所 有 清单 。 先 从 简单 的 开始 一 一 











c— 

































































«ul class="nav navbar-nav navbar-left"- 
<li><a href="{% url 'my lists' user.email %}">My lists«/a»«/li» 
</ul> 


22.5 下 移 一 层 到 视图 函数 〈 控 制 器 ) 


这 样 改 还 是 会 得 到 模板 错误 ， 所 以 要 从 表现 层 和 URL 层 下 移 ， 进 入 控制 器 层 ， 即 Django 
中 的 视图 函数 。 


一 如 既往 ， 先 写 测试 : 
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lists/tests/test views.py (ch191003) 
class MyListsTest(TestCase): 
def test my lists url renders my lists template(self): 


response = self.client.get('/lists/users/a(b.com/') 
self.assertTemplateUsed(response, 'my lists.html') 


得 到 的 测试 结果 为 : 


AssertionError: No templates used to render the response 


然后 修正 这 个 问题 ， 不 过 还 在 表现 层 ， 更 准确 地 说 是 urls.py: 























lists/urls.py 


urlpatterns = [ 
url(r'^newS', views.new list, name-'new list'), 
url(r'^(\d+)/$', views.view list, name-'view list'), 
url(r'^users/(.4)/S$', views.my lists, name-'my lists'), 


] 
修改 之 后 会 得 到 一 个 测试 失败 消息 ， 告 诉 我 们 移 到 下 一 层 之 后 要 做 什么 


AttributeError: module 'lists.views' has no attribute 'my lists' 


从 表现 层 移 到 视图 层 ， 再 定义 一 个 最 简单 的 占 位 视图 : 











lists/views.py (ch191005) 


def my_lists(request, email): 
return render(request, 'my lists.html') 


以 及 一 个 最 简单 的 模板 : 


lists/templates/my. lists.html 
{% extends 'base.html' X) 
{% block header text %}My Lists{% endblock 96) 
现在 单元 测试 通过 了 ， 但 功能 测试 毫 无 进展 ， 报 错 说 “My Lists” 页 面 没 有 显示 清单 。 功 
能 测试 希望 这 些 清单 可 以 点 击 ， 而 且 以 第 一 个 待 办 事项 命名 : 
$ python3 manage.py test functional tests.test my lists 
[4 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: Reticulate splines 


22.6 ”使 用 由 外 而 内 技术 ， 再 让 一 个 测试 通过 


仍然 使 用 功能 测试 驱动 每 一 步 的 开发 工作 。 


再 次 从 外 层 开始 ， 编 写 模板 代码 ， 让 “My Lists” 页 面 实现 设想 的 功能 。 现 在 ， 要 指定 希 
望 从 低层 获取 的 API。 




















^ = 
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22.6.1 快速 重组 模板 的 继承 层级 


基 模 板 目 前 没有 地 方 放 置 新 内 容 了 ， 而 且 “My Lists” 页 面 不 需要 新 建 待 办 事项 表单 ， 所 
以 把 表单 放 到 一 个 块 中 ， 需 要 时 才 显 示 























lists/templates/base.html (ch191007- 1) 


«div class="row"> 
«div class-"col-md-6 col-md-offset-3 jumbotron"» 
«div class-"text-center"» 
<h1>{% block header text %}{% endblock *j«/hi» 
(* block list form %} 
«form method="POST" action="{% block form action %}{%  endblock %}"> 
{{ form.text }} 
{% csrf_token %} 
{% if form.errors %} 
<div class="form-group has-error"> 
<div class="help-block">{{ form.text.errors }}</div> 
</div> 
{% endif %} 
</form> 
{% endblock *) 
</div> 
</div> 
</div> 


lists/templates/base.html (chl 91007-2) 


<div class="row"> 
<div class="col-md-6 col-md-offset-3"> 
{% block table %} 
{% endblock *) 
</div> 
</div> 


<div class="row"> 
<div class="col-md-6 col-md-offset-3"> 
{% block extra_content %} 
{% endblock %} 
</div> 
</div> 


</div> 


«script src="/static/jquery-3.1.1.min.js"></script> 


[22] 


22.6.2 ”使 用 模板 设计 API 
同时 ， 在 my_lists.html 中 覆盖 List_form 块 ， 把 块 中 的 内 容 清空 : 




















lists/templates/my lists.html 
(* extends 'base.html' %} 
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{% block header text %}My Lists{% endblock 9) 


(* block list form %}{% endblock %} 


然后 只 在 extra content 块 中 编写 代码 : 


在 这 


0 
e 


再 次 


虽然 





lists/templates/my lists.html 
[...] 


(96 block list form %}{% endblock %} 


{% block extra content X) 
<h2>{{ owner.email }}'s lists</h2> Q9 
<ul> 
{% for list in owner.list_set.all X) 6 
<li><a href="{{ list.get absolute url }}">{{ list.name }}</a></li> 6 
{% endfor %} 
</ul> 
{% endblock *) 


个 模板 中 我 们 做 了 几 个 设计 决策 ， 这 会 对 内 层 代 码 产生 一 定 影响 。 
需要 一 个 名 为 owner 的 变量 ， 在 模板 中 表示 用 户 。 


想 使 用 owner. list_set.all 遍历 用 户 创建 的 清单 (我 碰巧 知道 Django ORM 提供 了 这 
个 属性 ) 。 


想 使 用 list.name 获取 请 单 的 名 字 ， 目 前 清单 以 其 中 的 第 一 个 待 办 事项 命名 。 









































由 外 而 内 的 TDD 有 时 叫 作 “一 厢 情 愿 式 编程 ”， 我 想 你 能 看 出 为 什么 。 我 
们 先 编写 高 层 代 码 ， 这 些 代 码 建立 在 设想 的 低层 基础 之 上 ， 可 是 低层 尚未 








o 











运行 功能 测试 ， 确 认 没 有 造成 任何 破坏 ， 同 时 查看 有 无 进展 : 


$ python manage.py test functional tests 
[4x1 

selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: Reticulate splines 


Ran 8 tests in 77.613s 

FAILED (errors-1) 

没 进 展 ， 但 至 少 没 造成 任何 破坏 。 该 提交 了 : 
$ git add lists 


$ git diff --staged 
$ git commit -m "url, placeholder view, and first-cut templates for my lists" 
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22.6.3” 移 到 下 一 层 : 视图 向 模板 中 传 入 什么 


现在 ， 视 图 层 要 回应 需求 ， 为 模板 层 提供 所 需 的 对 象 。 这 里 要 提供 的 是 清单 属 主 : 























lists/tests/test views.py (ch191011) 


from django.contrib.auth import get user model 
User - get user model() 

[...] 

class MyListsTest(TestCase): 


def test my lists url renders my lists template(self): 


[52] 


def test passes correct owner to template(self): 
User.objects.create(email-'wrongQowner.com') 
correct user = User.objects.create(email-'a(bb.com') 
response = self.client.get('/lists/users/a(bb.com/') 
self.assertEqual(response.context['owner'], correct user) 


测试 结果 为 : 


KeyError: 'owner' 
那 就 这 么 修改 ， 


lists/views.py (ch191012) 


from django.contrib.auth import get user model 
User = get user model() 


[555] 
def my lists(request, email): 


owner = User.objects.get(emailzemail) 
return render(request, 'my lists.html', ('owner': owner}) 


这 样 修改 之 后 ， 新 测试 通过 了 ， 但 还 是 能 看 到 前 一 个 测试 导致 的 错误 。 只 需 在 这 个 测试 中 
添加 一 个 用 户 即 可 : 


lists/tests/test views.py (ch191013) 
def test my lists url renders my lists template(self): 
User.objects.create(email-'aQb.com') 
[eal 
现在 测试 全 部 通过 : 


22.7 ”视图 层 的 下 一 个 需求 : 新 建 清单 时 应 该 记录 
属 主 


下 移 到 模型 层 之 前 ， 视 图 层 还 有 一 部 分 代码 要 用 到 模型 : 如 果 当 前 用 户 已 经 登录 网 站 ， 需 
要 一 种 方式 把 新 建 的 清单 指派 给 一 个 属 主 。 
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初期 编写 的 测试 如 下 所 示 : 





lists/tests/test views.py (ch191014) 


class NewListTest(TestCase): 


[...] 


def test list owner is saved if user is authenticated(self): 
user = User.objects.create(email-'aQ(b.com') 
self.client.force login(user) ©@ 
self.client.post('/lists/new', data-('text': 'new item')) 
list = List.objects.first() 
self.assertEqual(list .owner, user) 


@ 为 了 让 测试 客户 端 利用 已 登录 用 户 的 身份 发 送 请 求 ， 必 须 先 调用 force loginO., 
这 个 测试 得 到 的 失败 消息 如 下 : 
AttributeError: 'List' object has no attribute 'owner' 


为 了 修正 这 个 问题 ， 可 以 尝试 编写 如 下 代码 : 


lists/views.py (ch191015) 


def new list(request): 

form = ItemForm(data-request.POST) 

if form.is valid(): 
list = List() 
list .owner = request.user 
list .save() 
form.save(for list-list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', ["form": form}) 


但 这 个 视图 其 实 解决 不 了 问题 ， 因 为 还 不 知道 怎么 保存 清单 的 属 主 : 


self.assertEqual(list .owner, user) 
AttributeError: 'List' object has no attribute 'owner' 


抉择 时 刻 : 测试 失败 时 是 否 要 移入 下 一 层 

为 了 让 这 个 测试 通过 ， 就 目前 的 情况 而 言 ， 要 下 移 到 模型 层 。 但 还 有 一 个 失败 测试 ， 要 做 
的 工作 太 多 ， 现 在 下 移 可 不 明智 。 

可 以 采用 另 一 种 策略 ， 使 用 到 件 把 测试 和 下 层 组 件 更 明显 地 隔离 开 。 

一 方面 ， 使 用 驭 件 要 做 的 工作 更 多 ， 而 且 驭 件 会 让 测试 代码 更 难 读 人 私 。 男 一 方面 ， 如 果 应 
用 更 复杂 ， 外 部 和 内 部 之 间 的 分 层 更 多 ， 测 试 就 会 涉及 3~5 层 ， 在 深入 最 底层 实现 关键 功 
能 之 前 ， 这 些 测试 一 直 处 于 失败 状态 。 测 试 无 法 通过 ， 单 就 一 层 而 言 ， 我 们 就 无 法 确定 它 
是 否 能 正常 运行 ， 只 有 等 到 最 底层 实现 之 后 才 有 答案 

你 在 自己 的 项 目 中 有 可 能 也 会 遇 到 这 样 的 抉择 时 刻 。 两 种 方式 都 要 探讨 。 先 走 捷径 ， 放 任 
测试 失败 不 管 。 下 一 章 再 回 到 这 里 ， 探讨 如 何 使 用 增强 隔离 的 方式 。 
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下 面 做 次 提交 ， 并 且 为 这 次 提交 打上 标签 ， 以 便 下 一 章 能 找到 这 个 位 置 : 


$ git commit -am "new list view tries to assign owner but cant" 
$ git tag revisit this, point with isolated tests 


22.8 下 移 到 模型 层 


使 用 由 外 而 内 技术 得 出 了 两 个 需求 ， 需 要 在 模型 层 实现 : 其 一 ， 想 使 用 .owner 属性 为 清单 
指派 一 个 属 主 ， 其 二 ， 想 使 用 API ower.list_set.all 获取 清单 的 属 主 。 


针对 这 两 个 需求 ， 先 编写 一 个 测试 : 












































lists/tests/test models.py (ch191018) 


from django.contrib.auth import get user model 
User = get user model() 


[5535] 
class ListModelTest(TestCase): 


def test get absolute url(self): 
[537] 


def test lists can have owners(self): 
user = User.objects.create(email-'a(b.com') 
list = List.objects.create(owner-user) 
self.assertIn(list , user.list set.all()) 


又 得 到 了 一 个 失败 的 单元 测试 


list = List.objects.create(owner-user) 


[eri 


TypeError: 'owner' is an invalid keyword argument for this function 
单 些 ， 把 模型 写成 下 面 这 样 : 


from django.conf import settings 


Es 


T 
lr. 





class List(models.Model): 
owner - models.ForeignKey(settings.AUTH USER MODEL) 


可 是 我 们 希望 属 主 可 有 可 无 。 明 确 表明 需求 比 含糊 其 辞 强 ， 而 且 济 试 还 可 以 作为 文档 ， 所 
以 再 编写 一 个 测试 








lists/tests/test models.py (ch191020) 


def test list owner is optional(self): 
List.objects.create() # 不 该 抛 出 异常 


正确 的 模型 实现 如 下 所 示 : 





lists/models.py 


from django.conf import settings 


[...] 
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class List(models.Model): 


owner - models.ForeignKey(settings.AUTH USER MODEL, blank-True, null-True) 


def get absolute url(self): 
return reverse('view list', args-[self.id]) 


现在 运行 测试 ， 会 看 到 以 前 见 过 的 数据 库 错误 : 


return Database.Cursor.execute(self, query, params) 
django.db.utils.OperationalError: no such column: lists list.owner id 


因为 需要 做 一 次 迁移 : 


$ python manage.py makemigrations 
Migrations for 'lists': 
lists/migrations/0006 list owner.py 
- Add field owner to list 


快 成 功 了 ， 不 过 还 有 几 个 错误 : 
ERROR: test redirects after POST (lists.tests.test_views.NewListTest) 
[...] 
ValueError: Cannot assign "«SimpleLazyObject: 
«django.contrib.auth.models.AnonymousUser object at 0x7f364795ef90»2": 


"List.owner" must be a "User" instance. 
ERROR: test can save a POST request (lists.tests.test views.NewlistTest) 


[5] 
ValueError: Cannot assign "«SimpleLazyObject: 
«django.contrib.auth.models.AnonymousUser object at 0x7f364795ef90»2": 


"List.owner" must be a "User" instance. 


现在 回 到 视图 层 ， 做 些 清理 工作 。 注 意 ， 这 些 错误 发 生 在 针对 new list HL 














E 














的 测试 


中 ， 而 且 用 户 没 有 登录 。 仅 当 用 户 登 录 后 才 应 该 保存 清单 的 属 主 。 在 第 19 章 中 定义 的 
.is authenticated() 国 数 现在 有 用 处 了 (用 户 未 登录 时 ，Django 使 用 AnonymousUser 类 表 








示 用 户 ， 此 时 .is_authenticated() 函数 的 返回 值 始终 是 False) : 


lists/views.py (ch191023) 


if form.is valid(): 
list - List() 
if request.user.is authenticated: 
list .owner = request.user 
list .save() 
form.save(for list-list ) 








[52] 
这 样 修改 之 后 ， 测 试 通过 了 : 
$ python manage.py test lists 
[ed 
Ran 39 tests in 0.237s 
OK 
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现在 是 提交 的 好 时 机 : 


$ git add lists 
$ git commit -m "lists can have owners, which are saved on creation." 


最 后 一 步 : 实现 模板 需要 的 .name 属 性 
使 用 的 由 外 而 内 设计 方式 还 有 最 后 一 个 需求 ， 即 清单 根据 其 中 第 一 个 待 办 事项 命名 ， 


你 可 














lists/tests/test models.py (ch191024) 


def test list name is first item text(self): 
list = List.objects.create() 
Item.objects.create(list-list , text-'first item') 
Item.objects.create(list-list , text-'second item') 
self.assertEqual(list .name, 'first item') 


lists/models.py (ch191025) 


Qproperty 
def name(self): 
return self.item set.first().text 


能 无 法 相信 ， 这 样 测试 就 能 通过 了 ， 而 且 “My Lists" Wim (Anl 22-1) 也 能 使 用 了 。 


$ python manage.py test functional tests 
[>] 
Ran 8 tests in 93.819s 





OK 











) To-Do lists - Mozilla Firefox 


File Edt View History Bookmarks Tools Help 








£3 To-Do lists | T | 
É | @ locahost:a081listsiusersiedith%40email.com] e | |E- coooe Plt A 
Superlists My lists Logged in as edith@email.com Log out 


My Lists 


id a com's lists 





x WebDriver 














22-1: 光彩 夺目 的 “My Lists” 页 面 (也 证 明 我 在 Windows 中 测试 过 ) 
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Python 中 的 eproperty 修饰 器 


如 果 你 没 见 过 @property 修饰 器 ， 我 告诉 你 ， 它 的 作用 是 把 类 中 的 方法 转变 成 与 属性 
一 样 ， 可 以 在 外 部 访问 。 


这 是 Python 语言 一 个 强大 的 特性 ， 因 为 很 容易 用 它 实现 “鸭子 类 型 ”(duck typing), 
无 须 修 改 类 的 接口 就 能 改变 属性 的 实现 方式 。 也 就 是 说 ， 如 果 想 把 .name 改 成 模型 真 
正 的 属性 ， 在 数据 库 中 存储 文本 型 数据 ， 整 个 过 程 是 完全 透明 的 ， 只 要 兼顾 其 他 代码 ， 
就 能 继续 使 用 .name 获取 清单 名 ， 完 全 不 用 知道 这 个 属性 的 具体 实现 方式 。 几 年 前 ， 
Raymond Hettinger 在 Pycon 上 针对 这 个 话题 做 过 一 次 出 色 的 演讲 。 这 个 演讲 对 新 手 友 
好 ， 我 极力 推荐 你 观看 ( 除 此 之 外 ， 还 涵盖 众多 符合 Python 风格 的 类 设计 实践 方式 ) 。 


当然 了 ， 就 算 没 使 用 Gproperty 修饰 器 ， 在 Django 的 模板 语言 中 还 是 会 调用 .name 方 
法 。 不 过 这 是 Django 专 有 的 特性 ， 不 适用 于 一 般 的 Python 程序 。 








但 这 个 过 程 中 有 作 浆 。 测 试 山羊 正 满怀 猜疑 。 实 现下 一 层 时 前 一 层 还 有 失败 的 测试 。 下 一 
章 要 看 一 下 增强 测试 隔离 性 如 何 编写 测试 。 











由 外 而 内 的 TDD 

。 由 外 而 内 的 TDD 
一 种 编写 代码 的 方法 ， 由 测试 驱动 ， 从 外 层 开 始 (表现 层 ，GUI) ， 然 后 逐步 向 内 
层 移 动 ， 通 过 视图 层 或 控制 器 层 ， 最 终 达 到 模型 层 。 这 种 方法 的 理念 是 由 实际 需要 
使 用 的 功能 驱动 代码 的 编写 ,而 不 是 在 低层 猜测 需求 。 

。 —Jü TR RARE. 
由 外 而 内 的 过 程 有 时 也 叫 “ 一 厢 情 愿 式 编程 ”。 其 实 ， 任 何 TDD 形式 都 涉及 一 厢 情 
愿 。 我 们 总 是 为 还 未 实现 的 功能 编写 测试 。 

。 由 外 而 内 技术 的 缺点 
由 外 而 内 技术 也 不 是 万 灵 药 。 这 种 技术 鼓励 我 们 关注 用 户 立 即 就 能 看 到 的 功能 ， 但 
不 会 自动 提醒 我 们 为 不 是 那么 明显 的 功能 编写 关键 测试 ， 例 如 安全 相关 的 功能 。 你 
自己 要 记得 编写 这 些 测试 。 
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第 23 章 


测试 隔离 和 “倾听 测试 的 心声 








前 一 章 对 视图 层 的 失败 单元 测试 放任 不 管 ， 而 是 进入 模型 层 编写 更 多 的 测试 和 更 多 的 代 
码 ， 以 便 让 这 个 测试 通过 。 

测试 侥 季 通过 了 ， 因 为 我 们 的 应 用 很 简单 。 我 要 强调 一 点 ， 在 复杂 的 应 用 中 ， 选 择 这 么 做 
是 很 危险 的 。 尚 未 确定 高 层 是否 真 正 完成 之 前 就 进入 低层 是 一 种 冒险 行为 。 








M 





感谢 Gary Bernhardt， 他 看 了 前 一 章 的 草稿 ， 建 议 我 深入 介绍 测试 隔离 。 








确保 各 层 之 间 相 互 隔离 确实 需要 投入 更 多 的 精力 (以 及 更 多 可 怕 的 驶 件 )， 可 是 这 么 做 能 
促使 我 们 得 到 更 好 的 设计 。 本 章 就 以 实例 说 明 这 一 点 。 


23.1 重 温 抉 择 时 刻 : 视图 层 依赖 于 尚未 编写 的 
模型 代码 


重 温 前 一 章 的 抉择 时 刻 ， 那 时 new list 视图 无 法 正常 运行 ， 因 为 清单 还 没有 .owner 属性 。 
我 们 要 逆转 时 光 ， 通 过 前 面 做 的 标签 检 出 以 前 的 代码 ， 看 一 下 使 用 隔离 性 更 好 的 测试 效果 
如 何 。 


$ git checkout -b more-isolation # 为 这 次 实验 新 建 一 个 分 支 
$ git reset --hard revisit this, point with isolated tests 


失败 的 测试 是 下 面 这 个 : 
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lists/tests/test views.py 


class NewListTest(TestCase): 


[...] 


def test list owner is saved if user is authenticated(self): 
user = User.objects.create(email-'aQ(b.com') 
self.client.force login(user) 
self.client.post('/lists/new', data-('text': 'new item']) 
list = List.objects.first() 
self.assertEqual(list .owner, user) 


尝试 使 用 的 解决 方法 如 下 所 示 ; 
lists/views.py 


def new list(request): 

form = ItemForm(data-request.POST) 

if form.is valid(): 
list = List() 
list .owner = request.user 
list .save() 
form.save(for list-list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', ["form": form}) 


此 时 ， 这 个 视图 测试 是 失败 的 ， 因 为 还 未 编写 模型 层 : 


self.assertEqual(list .owner, user) 
AttributeError: 'List' object has no attribute 'owner' 

















如 果 没 有 签 出 以 前 的 代码 并 还 原 lists/models.py， 就 不 会 看 到 这 个 错误 。 这 一 
步 一 定 要 做 。 本 章 的 目标 之 一 是 ， 看 一 下 是 否 真能 为 还 不 存在 的 模型 层 编写 
测试 。 











23.2 ”首先 尝试 使 用 驭 件 实现 隔离 
清单 还 没有 属 主 ， 但 可 以 使 用 一 些 模拟 技术 让 视图 层 测 试 认为 有 居 
lists/tests/test views.py (ch201003) 


HH 











from unittest.mock import patch 


[...] 


@patch('lists.views.List') © 

Gpatch('lists.views.ItemForm') 6 

def test list owner is saved if user is authenticated( 
self, mockItemFormClass, mockListClass © 

): 
user = User.objects.create(email-'aQ(b.com') 
self.client.force login(user) 





self.client.post('/lists/new', data-('text': 'new item'}) 


mock list = mockListClass.return value @ 
self.assertEqual(mock list.owner, user) ©@ 


@ 模拟 List 模型 的 功能 ， 获 取 视 图 创建 的 任何 一 个 清单 。 

© 此外， 还 要 模拟 ItemForm。 如 若 不 然 ， 调 用 form.saveO 时 ， 表 单 会 抛 出 错误 ， 因 为 
无 法 在 想 创建 的 Item 对 象 中 使 用 双 件 做 外 键 。 一 旦 开始 使 用 双 件 ， 就 很 难 停 手 ! 

e ”通过 测试 方法 的 参数 注入 驭 件 时 ， 要 按照 声明 双 件 的 相反 顺序 传 入 。 有 多 个 驶 件 时 ， 
方法 的 签名 就 是 这 么 奇怪 ,习惯 就 好 。 

o ”视图 访问 的 清单 实例 是 List 驭 件 的 返回 值 。 

e ”现在 可 以 声明 断言 ， 判 断 清单 对 象 是 否 设 定 了 .owner 属性 。 

现在 运行 测试 应 该 可 以 通过 : 
E manage.py test lists 


Ran 37 tests in 0.145s 
OK 


如 有 果 设 通过 ， 确 保 views.py 中 的 视图 代码 和 我 前 面 给 出 的 一 模 一 样 ， 使 用 的 是 ListO, m 


不 是 List.objects.create。 
































使 用 双 件 有 个 局 限 ， 必 须 按照 特定 的 方式 使 用 API。 这 是 使 用 双 件 对 象 要 做 
出 的 妥协 之 一 。 





使 用 驭 件 的 side_effect 属 性 检查 事件 发 生 的 顺序 
这 个 测试 的 问题 是 ， 无 意 中 把 代码 写 错 也 可 能 侥幸 通过 测试 。 假 设 在 指定 属 主 之 前 不 小 心 
调用 了 save 方法 


lists/views.py 


if form.is valid(): 
list = List() 
list .save() 
list .owner = request.user 
form.save(for list-list ) 
return redirect(list ) 


按照 测试 现在 这 种 写法 ， 它 依旧 可 以 通过 : 
OK 


所 以 ， 严 格 来 说 ,不仅 要 检查 指定 了 属 主 ， 还 要 确保 在 清单 对 象 上 调用 save 方法 之 前 就 已 
经 指定 了 。 
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件 时 周围 的 状态 : 











lists/tests/test views.py (ch201005) 


(Qpatch('lists.views.List') 

(Qpatch('lists.views.ItemForm') 

def test list owner is saved if user is authenticated( 
self, mockItemFormClass, mockListClass 


Js 


user = User.objects.create(email='a@b.com') 
self.client.force_login(user) 
mock_list = mockListClass.return_value 


def check owner assigned(): ©@ 
self.assertEqual(mock list.owner, user) 
mock list.save.side effect - check owner assigned 6 


self.client.post('/lists/new', data-('text': 'new item']) 


mock list.save.assert called once with() € 


定义 一 个 函数 ， 在 这 个 函数 中 就 希望 先 发 生 的 事件 声明 断言 ， 即 检查 是 否 设 定 了 清单 
的 属 主 。 

把 这 个 检查 函数 赋值 给 后 续 事件 的 side_effect 属性 。 当 视图 在 双 件 上 调用 save 方法 
I, 才 会 执行 其 中 的 断言 。 要 保证 在 测试 的 目标 了 数 调 用 前 完成 此 次 赋值 。 


， 要 确保 设 定 了 side_effect 属性 的 函数 一 定 会 被 调用 ， 也 就 是 要 调用 .save() 
id 否则 断言 永远 不 会 运行 。 





























使 用 驭 件 的 副作用 时 有 两 个 常见 错误 : 第 一 ，side_effect 属性 赋值 太 晚 ， 
也 就 是 ERÜRMIBUHESIBBCO RA ME, B xlix d RA T Spi 
作用 的 函数 。 说 “常见 ”"， 是 因为 撰写 本 章 时 我 多 次 同时 犯 了 这 两 个 错误 。 




















现在 ， 如 有 果 仍然 使 用 前 面 有 错误 的 代码 ， 即 指定 属 主 和 调用 save 方法 的 顺序 不 对 ， 就 会 看 
到 如 下 错误 : 











FAIL: test list owner is saved if user is authenticated 
(lists.tests.test views.NewListTest) 
[«««] 
File "/.../superlists/lists/views.py", line 17, in new list 
list .save() 
[5] 
File "/.../superlists/lists/tests/test views.py", line 74, in 
check owner assigned 
self.assertEqual(mock list.owner, user) 
AssertionError: «MagicMock name-'List().owner' id-z'140691452447208'» !- «User: 
User object» 


注意 看 这 个 失败 消息 ， 它 先 尝试 保存 ， 然 后 才 执行 side_effect 属性 对 应 的 函数 。 
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可 以 按照 下 面 的 方式 修改 ， 让 测试 通过 : 


lists/views.py 


if form.is valid(): 
list = List() 
list .owner = request.user 
list .save() 
form.save(for list-list ) 
return redirect(list ) 


测试 结果 为 : 


OK 


但 是 这 个 测试 写 得 很 丑 ! 


23.3 ”倾听 测试 的 心声 : 丑陋 的 测试 表明 需要 重 构 


当 你 发 现 必 须 像 这 样 编写 测试 ， 而 且 要 做 许多 工作 时 ， 很 有 可 能 表明 测试 试图 向 你 诉说 什 
么 。 准 备 测 试 所 需 的 数据 用 了 8 行 代码 UHPOUEHT 217, ERRAT 3 行 ， 还 有 
3 行 设 定 副作用 函数 )， 太 多 了 。 

这 个 测试 试图 告诉 我 们 ， 视 图 做 的 工作 太 多 了 ， 既 要 创建 表单 ， 又 要 创建 清单 对 象 ， 还 要 
决定 是 否 保存 清单 的 属 主 。 
前 面 已 经 说 过 ， 可 以 把 一 部 分 工作 交 给 表单 类 完成 ， 把 视图 变 得 简单 且 易 于 理解 一 些 。 藉 
什么 要 在 视图 中 创建 清单 对 象 ? 或 许 ItemForm.save 能 代劳 ? 为 什么 视图 要 决定 是 否 保存 
request.user ? 这 项 任务 也 可 以 交 给 表单 完成 。 

既然 要 把 更 多 的 任务 交 给 表单 ， 感 觉 应 该 为 这 个 表单 起 个 新 名 字 。 可 以 叫 它 NewListForm, 
因为 这 个 名 字 能 更 好 地 表明 它 的 作用 。 最 终 ， 视 图 或 许可 以 写成 这 样 吧 : 



















































































lists/views.py 
# 先 不 输入 这 段 代 码 ， 只 是 假设 可 以 这 么 写 


def new list(request): 
form = NewListForm(data-request.POST) 
if form.is valid(): 
list = form.save(owner-request.user) # 创建 List 和 Item 对 象 
return redirect(list ) 
else: 
return render(request, 'home.html', ["form": form)) 


这 样 多 简洁 ! 下 面 来 看 一 下 如 何 为 这 种 写法 编写 完全 隔离 的 测试 。 


23.4 ”以 完全 隔离 的 方式 重 写 视 图 测试 


首次 尝试 为 这 个 视图 编写 的 测试 组 件 集成 度 太 高 ， 数 据 库 层 和 表单 层 的 功能 完成 之 后 才能 
通过 。 现 在 使 用 另 一 种 方式 ， 提 高 测试 的 隔离 度 。 
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23.4.1 为 了 新 测试 的 健全 性 ， 保 留 之 前 的 整合 测试 组 件 
把 NewListTest 类 重 名 为 NewListViewIntegratedTest， 再 把 尝试 使 用 驭 件 保 存 属 主 的 测试 
代码 删 掉 ， 换 成 整合 版 本 ， 而 且 暂 时 为 这 个 测试 方法 加 上 skip f fa 





lists/tests/test views.py (ch201008) 


import unittest 


[x] 
class NewListViewIntegratedTest(TestCase): 


def test can save a POST request(self): 


[5s] 


Qunittest.skip 

def test list owner is saved if user is authenticated(self): 
user = User.objects.create(email-'a(b.com') 
self.client.force login(user) 
self.client.post('/lists/new', data-('text': 'new item')) 
list = List.objects.first() 
self.assertEqual(list .owner, user) 


你 听 说 过 “集成 测试 ”(integration test) 这 个 术语 吗 ? 想 知 道 它 和 “整合 测 
TX" (integrated test). 的 区 别 吗 ? 请 看 第 26 章 框 注 中 的 定义 。 





$ python manage.py test lists 
[si] 

Ran 37 tests in 0.139s 

OK 


23.4. ”完全 隔离 的 新 测试 组 件 

: mh 看 看 隔离 测试 能 否 驱 动 我 们 写 出 new_list 视图 的 替代 版 本 。 把 这 个 视 
命名 为 new_Ltst2， 放 在 旧版 视图 旁边 。 写 好 之 后 ， 再 换 用 这 个 新 视图 ， 看 看 以 前 的 整 

I| 试 是 否 仍 然 都 能 通过 。 









































lists/views.py (ch201009) 


def new list(request): 


E] 


def new list2(request): 
pass 


23.4.3 ”站 在 协作 者 的 角度 思考 问题 


重 写 测试 时 车 想 实现 完全 隔离 ， 必 须 丢 掉 以 前 对 测试 的 认识 。 以 前 我 们 认为 视图 的 真正 作 
用 是 操作 数据 库 等 ， 现 在 则 要 站 在 协作 对 象 的 角度 ， 思 考 视 图 如 何 与 之 交互 。 
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站 在 新 的 角度 上 ， 发 现 视 图 的 主要 协作 者 是 表单 对 象 。 所 以 ， 为 了 完全 掌控 表单 ， 以 及 按 


照 我 们 一 厢 情 愿 想 要 的 方式 定义 表单 的 功能 ， 使 用 双 件 模拟 表单 。 


© 




















lists/tests/test_views.py (ch201010) 


from unittest.mock import patch 
from django.http import HttpRequest 
from lists.views import new_list2 


[ca] 


Gpatch('lists.views.NewListForm') @ 
class NewListViewUnitTest(unittest.TestCase): © 


def setUp(self): 
self.request - HttpRequest() 
self.request.POST['text'] = 'new list item' 6 


def test passes POST data to NewListForm(self, mockNewListForm): 
new list2(self.request) 
mockNewListForm.assert called once with(data-self.request.POST) @ 


使 用 Django 提供 的 TestCase 类 大 容易 写成 整合 测试 。 为 了 确保 写 出 纯粹 隔离 的 单元 
测试 ， 只 能 使 用 unittest.TestCase, 

模拟 NewListForm 类 〈 尚 未 定义 ) 。 类 中 的 所 有 测试 方法 都 会 用 到 这 个 驭 件 ， 所 以 在 类 
上 模拟 。 

在 setUp 方法 中 手动 创建 了 一 个 简单 的 POST 请 求 ， 没 有 使 用 ( 太 过 整合 的 ) Django 
测试 客户 端 。 
然后 检查 视图 要 做 的 第 一 件 事 : 在 视图 中 使 用 正确 的 构造 方法 初始 化 它 的 协作 者 ， 即 
NewListForm， 传 和 人 的 数据 从 请 求 中 读 取 。 















































在 这 个 测试 的 结果 中 首先 会 看 到 一 个 失败 消息 ， 报 错 视图 中 还 没有 NewListForm。 





AttributeError: «module 'lists.views' from '/.../superlists/lists/views.py'» 
does not have the attribute 'NewListForm' 


先 编写 一 个 占 位 表单 类 : 








lists/views.py (ch201011) 


from lists.forms import ExistinglistItemForm, ItemForm, NewListForm 


以 及 : 


lists/forms.py (ch201012) 


class ItemForm(forms.models.ModelForm): 
class NewListForm(object): 
pass 


class ExistingListItemForm(ItemForm): 


[ss 
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看 到 了 一 个 真正 的 失败 消息 : 


AssertionError: Expected 'NewListForm' to be called once. Called 0 times. 


按照 如 下 的 方式 编写 代码 : 





lists/views.py (ch201012-2) 


def new list2(request): 
NewListForm(data-request.POST) 





测试 结果 为 : 
$ python manage.py test lists 
lira] 
Ran 38 tests in 0.143s 
OK 








AKER BMR. RRE RIRA, KERER RENH save 方法 : 








lists/tests/test views.py (ch201013) 


from unittest.mock import patch, Mock 


[ed 


@patch('lists.views.NewListForm') 
class NewListViewUnitTest(unittest.TestCase): 


def setUp(self): 
self.request = HttpRequest() 
self.request.POST['text'] = 'new list item' 
self.request.user - Mock() 


def test passes POST data to NewListForm(self, mockNewListForm): 
new list2(self.request) 
mockNewListForm.assert called once with(data-self.request.POST) 


def test saves form with owner if form valid(self, mockNewListForm): 
mock form = mockNewListForm.return value 
mock form.is valid.return value - True 
new list2(self.request) 
mock form.save.assert called once with(owner-self.request.user) 


据 此 ， 可 以 写 出 如 下 视图 : 








lists/views.py (ch201014) 


def new list2(request): 
form = NewListForm(data-request.POST) 
form.save(owner-request.user) 


如 果 表 单 中 的 数据 有 效 ， 让 视图 做 一 个 重 定向 ， 把 我 们 带 到 一 个 页 面 
的 对 象 。 所 以 要 模拟 视图 的 另 一 个 协作 者 一 一 redirect 函数 : 














， 查 看 表单 刚刚 创建 











© © © © 


© 


lists/tests/test views.py (ch201015) 


Gpatch('lists.views.redirect') © 
def test redirects to form returned object if form valid( 


Jé 


self, mock_redirect, mockNewListForm @ 


mock_form = mockNewListForm.return_value 
mock form.is valid.return value = True ©@ 


response - new list2(self.request) 


self.assertEqual(response, mock redirect.return value) ©@ 
mock redirect.assert called once with(mock form.save.return value) © 


模拟 redirect 函数 ， 不 过 这 次 直接 在 方法 上 模拟 。 
patch 修饰 器 先 应 用 最 内 层 的 那个 ， 所 以 这 个 驭 件 在 mockNewListForm 之 前 传人 方法 。 
指定 测试 的 是 表单 中 数据 有 效 的 情况 。 


检查 视 























图 的 响应 是 否 为 redirect 函数 的 结果 。 








然后 检查 调用 redirect 函数 时 传 入 的 参数 是 否 为 在 表单 上 调用 save 方法 得 到 的 对 象 。 
据 此 ， 可 以 编写 如 下 视图 : 











lists/views.py (ch201016) 


def new list2(request): 
form = NewListForm(data-request.POST) 


list = form.save(owner-zrequest.user) 
return redirect(list ) 
测试 结果 为 : 
$ python manage.py test lists 
PES 
Ran 40 tests in 0.163s 
OK 





然后 测试 表单 提交 失败 的 情况 一 一 如 有 果 表 单 中 的 数据 无 效 ， 泻 染 首页 的 模板 ; 





lists/tests/test views.py (ch201017) 


Gpatch('lists.views.render') 
def test renders home template with form if form invalid( 


Je 


self, mock_render, mockNewListForm 


mock_form = mockNewListForm.return_value 
mock_form.is_valid.return_value = False 


response = new_list2(self.request) 


self.assertEqual(response, mock render.return value) 
mock render.assert called once with( 
self.request, 'home.html', ('form': mock form) 


) 
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测试 的 结果 为 : 


AssertionError: «HttpResponseRedirect status code-302, "te[114 chars]%3E"> !- 
«MagicMock name-'render()' id-'140244627467408'» 





EDE EHAE SA JS IAS ER TWR, SRI CER AUC. DR 75 A br 
言 函数 时 太 容 易 出 错 ， 会 导致 调用 的 模拟 方法 没有 任何 作用 。( 我 会 写成 
asssert_called_once_with， 用 了 三 个 s。 你 自己 可 以 试 一 下 | ) 

















故意 犯 个 错误 ， 确 保 测 试 全 面 : 











lists/views.py (ch201018) 


def new list2(request): 
form = NewListForm(data-request.POST) 
list = form.save(owner-request.user) 
if form.is valid(): 
return redirect(list ) 
return render(request, 'home.html', ['form': form}) 


测试 本 不 应 该 通过 却 通过 了 ! 那 就 再 写 一 个 测试 : 
lists/tests/test views.py (ch201019) 


def test does not save if form invalid(self, mockNewListForm): 
mock form = mockNewListForm.return value 
mock form.is valid.return value - False 
new list2(self.request) 
self.assertFalse(mock form.save.called) 


这 个 测试 会 失败 : 


self.assertFalse(mock_form.save.called) 
AssertionError: True is not false 


最 终 得 到 了 一 个 精简 的 视 











| 





lists/views.py 


def new_list2(request): 
form = NewListForm(data=request.POST) 
if form.is_valid(): 
list = form.save(owner=request.user) 
return redirect(list ) 
return render(request, 'home.html', ['form': form]) 


测试 结果 为 : 


$ python manage.py test lists 
[5 «3 

Ran 42 tests in 0.163s 

OK 





23.5 下 移 到 表单 层 


已 经 写 好 了 视图 函数 ， 这 个 视图 基于 设想 的 表单 NewItemForm， 而 且 这 个 表单 现在 还 不 存在 。 


需要 在 表单 对 象 上 调用 save 方法 创建 一 个 新 清单 ， 还 要 使 用 通过 验证 的 POST 数据 创下 
个 新 待 办 事项 。 如 果 直 接 使 用 ORM, save 方法 可 以 写成 这 样 : 


class NewListForm(models.Form): 








Rİ 























B 








def save(self, owner): 
list = List() 
if owner: 
list .owner - owner 
list .save() 
item - Item() 
item.list - list. 
item.text - self.cleaned data['text'] 
item.save() 


这 种 实现 方式 依赖 于 模型 层 的 两 个 类 ， 即 Item 和 List。 那 么 隔离 性 好 的 测试 应 该 怎么 写 呢 ? 
class NewListFormTest(unittest.TestCase): 


Gpatch('lists.forms.List') © 
GQpatch('lists.forms.Item') © 
def test save creates new list and item from post data( 
self, mockItem, mockList ©@ 
): 
mock item - mockItem.return value 
mock list = mockList.return value 
user - Mock() 
form = NewListForm(data-['text': 'new item text')) 
form.is valid() @ 


def check item text and list(): 
self.assertEqual(mock item.text, 'new item text') 
self.assertEqual(mock item.list, mock list) 
self.assertTrue(mock list.save.called) 
mock item.save.side effect = check item text and list © 
form.save(ownerzuser) 
self.assertTrue(mock item.save.called) O 
@ ”为 表单 模拟 两 个 来 自 下 部 模型 层 的 协作 者 。 
@ ”必须 调用 is_valid() 方法 ， 这 样 表单 才 会 把 通过 验证 的 数据 存储 到 .cLeaned_data 字 
典 中 。 


© {EM side effect 方法 确保 保存 新 待 办 事项 对 象 时 ， 使 用 已 经 保存 的 清单 ， 而 且 待 办 
项 中 的 文本 正确 。 


@ 一如既往， 再 次 确认 调用 了 副作用 函数 。 
唉 ， 这 个 测试 写 得 好 壬 |! 











lin. 








H 
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始终 倾听 测试 的 心声 : 从 应 用 中 删除 ORM 代 码 


测试 又 在 诉说 什么 : Django ORM 很 难 模拟 ， 而 且 表 单 类 需要 较 深 入 地 了 解 ORM 的 工作 
方式 。 再 次 使 用 一 厢 情 愿 式 编程 ， 想 想 表单 想 用 什么 样 的 简单 API 呢 ? 下 面 这 种 怎么 样 : 


def save(self): 
List.create new(first item text-self.cleaned data['text']) 


又 冒 出 个 想法 : 要 不 在 List 类 中 定义 一 个 辅助 函数 ， 封 装 保存 新 清单 对 象 及 相关 的 第 一 
个 待 办 事项 这 部 分 逻辑 。 


那 就 先 为 这 个 想法 编写 测试 


























lists/tests/test forms.py (ch201021) 


import unittest 
from unittest.mock import patch, Mock 
from django.test import TestCase 


from lists.forms import ( 
DUPLICATE ITEM ERROR, EMPTY ITEM ERROR, 
ExistinglistItemForm, ItemForm, NewListForm 
) 
from lists.models import Item, List 


MIB 


class NewListFormTest(unittest.TestCase): 


(Qpatch('lists.forms.List.create new') 
def test save creates new list from post data if user not authenticated( 
self, mock List create new 
s 
user - Mock(is authenticated-False) 
form = NewListForm(data-['text': 'new item text']) 
form.is valid() 
form.save(owner-user) 
mock List create new.assert called once with( 
first item text-'new item text' 


) 
既然 已 经 测试 了 这 种 情况 ， 那 就 再 写 个 测试 检查 用 户 已 经 通过 认证 的 情况 吧 : 





lists/tests/test forms.py (ch201022) 


@patch('lists.forms.List.create_new') 

def test_save_creates_new_list_with_owner_if_user_authenticated( 
self, mock_List_create_new 

): 
user 
form 


Mock(is authenticated-True) 
NewListForm(data-['text': 'new item text')) 








1: 你 很 可 能 想 定义 一 个 单独 的 函数 ,但 是 放 在 类 中 有 利于 记 住 它 在 哪儿 。 更 重要 的 是 ， 还 能 表明 这 个 函 
数 的 作用 。 嗯 ， 我 保证 等 我 写 完 这 本 书 之 后 会 这 么 做 的 。 尖 锐 的 批评 就 此 打住 吧 ! 
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form.is valid() 

form.save(ownerzuser) 

mock List create new.assert called once with( 
first item text-'new item text', owner-user 


) 
可 以 看 出 ， 这 个 测试 易 读 多 了 。 下 面 开 始 实现 新 表单 。 先 从 import 语句 开始 : 














lists/forms.py (ch201023) 


from lists.models import Item, List 
此 时 驭 件 说 要 定义 一 个 占 位 的 create new 75 iX: 
AttributeError: <class 'lists.models.List'> does not have the attribute 


'create new' 


lists/models.py 
class List(models.Model): 


def get absolute url(self): 
return reverse('view list', args-[self.id]) 


def create new(): 
pass 


几 步 之 后 ， 最 终 写 出 如 下 的 save 方法 : 


lists/forms.py (ch201025) 


class NewListForm(ItemForm): 


def save(self, owner): 
if owner.is authenticated: 
List.create new(first item text-self.cleaned data['text'], owner=owner) 
else: 
List.create new(first item text-self.cleaned data['text']) 


而 且 测 试 也 通过 了 : 


$ python manage.py test lists 
Ran 44 tests in 0.192s 
OK 





把 ORM 代码 放 到 辅助 方法 中 
从 编写 隔离 测试 的 过 程 中 我 们 学 会 了 一 项 技能 “ORM 辅助 方法 ”。 
使 用 Django 的 ORM 可 以 通过 十 分 易 读 的 句法 (肯定 比 纯 SQL 好 得 多 ) 快速 完成 工 


作 。 但 有 些 人 喜欢 尽量 减少 应 用 中 使 用 的 ORM 代码 量 ， 尤 其 不 喜欢 在 视图 层 和 表单 
层 使 用 ORM 代码 。 





一 个 原因 是 ， 测 试 这 几 层 时 更 容易 ; 另 一 个 原因 是 ， 必 须 定 义 辅助 方法 ， 这 样 能 更 清 
晰 地 表述 域 远 辑 。 请 对 比 这 段 代 码 : 








H 
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list - List() 

list .save() 

item - Item() 

item.list - list. 

item.text - self.cleaned data['text'] 
item.save() 


和 这 段 代 码 : 
List.create new(first item text-self.cleaned data['text']) 
辅助 方法 同样 可 用 于 读 写 查 询 。 假 设 有 这 样 一 行 代码 : 
Book.objects.filter(in print-True, pub date lte-datetime.today()) 
fede T V BREL rC, HARAR B T UR. 
Book.all available books() 
定义 辅助 方法 时 ， 可 以 起 个 适当 的 名 字 ， 表 明 它 们 在 业务 还 辑 中 的 作用 。 使 用 辅助 方 


法 不 仅 可 以 让 代码 的 条 理 变 得 更 清晰 ， 还 能 把 所 有 ORM 调用 都 放 在 模型 层 ， 因 此 整 
个 应 用 不 同 部 分 之 间 的 耦合 更 松散 。 








23.6 下 移 到 模型 层 


在 模型 层 不 用 再 编写 隔离 测试 了， 因为 模型 层 的 目的 就 是 与 数据 库 结合 在 一 起 工作 ， 所 以 
编写 整合 测试 更 合理 : 























T 








lists/tests/test models.py (ch201026) 
class ListModelTest(TestCase): 


def test get absolute url(self): 
list = List.objects.create() 
self.assertEqual(list .get absolute url(), f'/lists/(list .id)/') 


def test create new creates list and first item(self): 
List.create new(first item text-'new item text') 
new item - Item.objects.first() 
self.assertEqual(new item.text, 'new item text') 
new list = List.objects.first() 
self.assertEqual(new item.list, new list) 


测试 的 结果 为 : 
TypeError: create new() got an unexpected keyword argument 'first item text' 


根据 测试 结果 ， 可 以 先 把 实现 方式 写成 这 样 : 























E 
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lists/models.py (ch201027) 
class List(models.Model): 


def get absolute url(self): 
return reverse('view list', args-[self.id]) 


@staticmethod 

def create_new(first_item_text): 
list_ = List.objects.create() 
Item.objects.create(text=first_item_text, list=list_) 


注意 ,一 路 走 下 来 ， 直 到 模型 层 ， 由 视图 层 和 表单 层 驱 动 ， 得 到 了 一 个 设计 良好 的 模型 ， 
但 是 List 模型 还 不 支持 属 主 。 


现在 ,测试 清单 应 该 有 一 个 属 主 。 添 加 如 下 测试 : 











lists/tests/test models.py (ch201028) 


from django.contrib.auth import get user model 
User - get user model() 


[5x] 


def test create new optionally saves owner(self): 
user - User.objects.create() 
List.create new(first item text-'new item text', owner-user) 
new list = List.objects.first() 
self.assertEqual(new list.owner, user) 


既然 已 经 打开 这 个 文件 ， 那 就 再 为 owner 属性 编写 一 些 测 试 吧 : 


lists/tests/test models.py (ch201029) 
class ListModelTest(TestCase): 


s] 


def test lists can have owners(self): 


List(owner-User()) # Pizie 
def test_list_owner_is_optional(self): 
List().full clean() # 不 该 抛 出 异常 


这 两 个 测试 和 前 一 章 使 用 的 测试 几乎 一 样 ， 不 过 我 稍微 改 了 些 ， 不 让 它们 保存 对 象 。 因 为 
对 这 个 测试 而 言 ， 内 存 中 有 这 些 对 象 就 行 了 











尽量 多 用 内 存 中 (未 保存 ) 的 模型 对 象 ， 这 样 测试 运行 得 更 快 。 





测试 的 结果 为 : 
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$ python manage.py test lists 

[5] 

ERROR: test create new optionally saves owner 

TypeError: create new() got an unexpected keyword argument 'owner' 

[...] 

ERROR: test lists can have owners (lists.tests.test models.ListModelTest) 
TypeError: 'owner' is an invalid keyword argument for this function 

[1] 

Ran 48 tests in 0.204s 

FAILED (errors-2) 


然后 按照 前 一 章 使 用 的 方式 实现 模型 : 


lists/models.py (ch201030-1) 


from django.conf import settings 


EPA 


class List(models.Model): 
owner - models.ForeignKey(settings.AUTH USER MODEL, blank-True, null-True) 
[a] 


此 时 ， 测 试 的 结果 中 有 各 种 完整 性 失败 ， 执 行 迁移 后 才能 解决 这 些 问 题 : 


执行 


django.db.utils.OperationalError: no such column: lists list.owner id 


迁移 后 再 运行 测试 ， 会 看 到 下 面 三 个 失败 : 


ERROR: test create new optionally saves owner 

TypeError: create new() got an unexpected keyword argument 'owner' 
[...] 

ValueError: Cannot assign "«SimpleLazyObject: 
«django.contrib.auth.models.AnonymousUser object at 0x7f5b2380b4e0»5": 
"List.owner" must be a "User" instance. 

ValueError: Cannot assign "«SimpleLazyObject: 
«django.contrib.auth.models.AnonymousUser object at 0x7f5b237a12e8»5": 
"List.owner" must be a "User" instance. 














先 处 理 第 一 个 失败 。 这 个 失败 由 create new 方法 导致 : 


lists/models.py (ch201030-3) 


@staticmethod 
def create new(first item text, owner=None): 
list = List.objects.create(owner-owner) 


Item.objects.create(text-first item text, list-list ) 


回 到 视图 层 


视图 














层 以 前 的 两 个 整合 测试 失败 了 ， 怎 么 回 事 呢 ? 


ValueError: Cannot assign "«SimpleLazyObject: 
«django.contrib.auth.models.AnonymousUser object at Ox7fbadicb6c10»2": 
"List.owner" must be a "User" instance. 











啊 ， 原 来 是 因为 以 前 的 视图 没有 分 清 谁 才 是 清单 的 属 主 : 

















lists/views.py 


if form.is valid(): 
list = List() 
list .owner = request.user 
list .save() 


这 一 刻 才 意识 到 以 前 的 代码 没有 满足 需求 。 修 正 这 个 问题 ， 让 所 有 测试 都 通过 : 


lists/views.py (ch201031) 


def new_list(request): 
form = ItemForm(data-request.POST) 
if form.is valid(): 
list = List() 
if request.user.is authenticated: 
list .owner = request.user 
list .save() 
form.save(for list-list ) 
return redirect(list ) 
else: 
return render(request, 'home.html', ["form": form)) 


def new list2(request): 


[...] 





整合 测试 的 好 处 之 一 是 ， 可 以 捕获 这 种 无 法 轻易 预测 的 交互 。 我 们 二 了 编写 
测试 检查 用 户 没 有 通过 验证 的 情况 ， 可 是 整合 测试 会 由 上 而 下 使 用 整个 组 
件 ， 最 终 模 型 层 出 现 了 错误 ， 提 醒 我 们 筷 了 一 些 事 。 









































$ python manage.py test lists 
[...] 


Ran 48 tests in 0.175s 
OK 


23.7 ”关键 时 刻 ， 以 及 使 用 模拟 技术 的 风险 


换 掉 以 前 的 视图 ， 使 用 新 视图 试 试 。 调 换 视 图 可 以 在 urls.py 中 完成 : 




















lists/urls.py 
[ss] 
url(r'^new$', views.new list2, name='new_list'), 
还 得 删除 整合 测试 类 上 的 untttest.skip 修饰 器 ， 看 看 为 清单 属 主编 写 的 新 代码 是 否 真 得 
可 用 : 
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lists/tests/test views.py (ch201033) 


class NewListViewIntegratedTest(TestCase): 


def test can save a POST request(self): 


[...] 


def test list owner is saved if user is authenticated(self): 
[...] 


self.assertEqual(list .owner, user) 














那么 测试 的 结果 如 何 呢 ? 啊 ， 情 况 不 妙 ! 


测试 隔离 有 个 很 重要 的 知识 点 : 虽然 它 有 可 能 帮助 你 为 单独 各 层 做 出 好 的 设计 ， 但 无 法 自 


ERROR: test list owner is saved if user is authenticated 


Deea] 
ERROR: test_can_save_a_POST_request 
[4 


ERROR: test redirects after POST 
(lists.tests.test views.NewListViewIntegratedTest) 
File "/.../superlists/lists/views.py", line 30, in new list2 
return redirect(list ) 
Eis] 


TypeError: argument of type 'NoneType' is not iterable 


FAILED (errors=3) 














动 验证 各 层 之 间 的 集成 情况 。 
上 述 测试 结果 表明 ， 视 图 期 望 表 单 返回 一 个 待 办 事项 : 














list = form.save(owner-request.user) 
return redirect(list ) 


但 没 让 表单 返回 任何 值 : 


况 下 ， 我 们 希望 尽早 得 到 反馈 
要 几 个 小 时 。 在 这 种 问题 发 生 之 前 有 没有 办 法 避免 呢 ? 














n 











def save(self, owner): 
if owner.is authenticated: 





lists/views.py 


lists/forms.py 


List.create new(first item text-self.cleaned data['text'], owner-owner) 


else: 


List.create new(first item text-self.cleaned data['text']) 


23.8 把 层 与 层 之 间 的 交互 当 作 “合约 ” 








除了 隔离 的 单元 测试 之 外 ， 就 算 什么 都 没 写 ， 功 能 测试 最 终 也 能 发 现 这 个 失误 。 但 理想 情 
功能 测试 可 能 要 运行 好 几 分 钟 ， 应 用 变 大 之 后 甚至 可 能 





E 论 上 讲 ， 有 办 法 : 把 层 与 层 之 间 的 交互 看 成 一 种 “合约 ”"。 只 要 模拟 一 层 的 行为 ， 就 要 在 
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‘CERE, EI5SEZRBSER TEKA, XERRI TARA P — BOUT HH 


遗忘 


@ ”模拟 的 form.save 方法 返回 一 个 对 象 ， 我 们 希望 在 视 


23.8. 


现在 要 








忘 的 合约 如 下 所 示 : 


lists/tests/test views.py 


@patch('lists.views.redirect') 

def test_redirects_to_form_returned_object_if_form_valid( 
self, mock_redirect, mockNewListForm 

) : 
mock form = mockNewListForm.return value 
mock form.is valid.return value - True 


response - new list2(self.request) 


self.assertEqual(response, mock redirect.return value) 
mock redirect.assert called once with(mock form.save.return value) © 


中 使 用 这 个 对 象 。 








T 


WRI 














1 找 出 隐形 合约 








审查 NewListViewUnitTest 类 中 的 每 个 测试 ， 看 看 各 驭 件 在 隐形 合约 中 表述 了 什么 : 











lists/tests/test views.py 


def test passes POST data to NewListForm(self, mockNewListForm): 
ER 


mockNewListForm.assert called once with(data-self.request.POST) Q9 


def test saves form with owner if form valid(self, mockNewListForm): 
mock form = mockNewListForm.return value 
mock form.is valid.return value - True 6 
new list2(self.request) 
mock form.save.assert called once with(owner-self.request.user) € 


def test does not save if form invalid(self, mockNewListForm): 


Essa] 
mock_form.is_valid.return_value = False @ 
[...] 


Qpatch('lists.views.redirect') 

def test redirects to form returned object if form valid( 
self, mock redirect, mockNewListForm 

Jé 
[...] 


mock redirect.assert called once with(mock form.save.return value) @ 


(Qpatch('lists.views.render') 
def test renders home template with form if form invalid( 


Dec] 
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@ ”需要 传 入 POST 请 求 中 的 数据 ， 以 便 初始 化 表单 。 
e ”表单 对 象 要 能 响应 is_valid() 方法 ,而 且 要 根据 输入 值 判断 返回 True 还 是 False, 


e ”表单 对 象 要 能 响应 .save 方 法， 而 且 传 入 的 参数 值 是 request.user， 然 后 根据 用 户 是 
否 登录 做 相应 处 理 。 


O ”表单 对 象 的 .save 方法 应 该 返回 一 个 新 清单 对 象 ， 以 便 视图 把 用 户 重 定向 到 显示 这 个 
IRAIA 


仔细 分 析 表 单 测试 ， 可 以 看 出 ， 其 实 只 明确 测试 了 @。@ 和 @ 很 幸运 ， 因 为 这 是 Django 中 
ModelForn 的 默认 特性 ， 而 且 针对 父 类 ItemForm 的 视 试 涵盖 了 这 两 点 。 


但 @ 却 成 了 漏网 之 鱼 。 


























o 

















使 用 由 外 而 内 的 TDD 技术 编写 隔离 测试 时 ， 要 记 住 每 个 测试 在 合约 中 对 下 
一 层 应 该 实现 的 功能 做 出 的 隐 仿 假设， 而且 记 得 稍 后 要 回来 测试 这 些 假设 。 
你 可 以 在 便签 上 记 下 来 ， 也 可 以 使 用 self.fail 编写 占 位 测试 。 




















23.8.2 ŻE FRAS SKAJE 
下 面 添加 一 个 新 测试 ， 确 保 表单 返回 刚刚 保存 的 清单 : 


lists/tests/test forms.py (ch201038-1) 

















(patch('lists.forms.List.create new') 
def test save returns new list object(self, mock List create new): 
user - Mock(is authenticated-True) 
form = NewListForm(data-['text': 'new item text'}) 
form.is valid() 
response - form.save(owner-user) 
self.assertEqual(response, mock List create new.return value) 


其 实 ， 这 是 个 很 好 的 示例 一 一 和 List.create new 之 间 有 隐形 合约 ， 希 望 这 个 方法 返回 刚 
创建 的 清单 对 象 。 下 面 为 这 个 需求 添加 一 个 占 位 测试 : 


lists/tests/test models.py (ch201038-2) 

















class ListModelTest(TestCase): 


[...] 


def test create returns new list object(self): 
self.fail() 


得 到 一 个 失败 测试 ， 告 诉 我 们 要 修正 表单 对 象 的 save 方法 : 


AssertionError: None != «MagicMock name='create_new()' id='139802647565536'> 
FAILED (failures-2, errors-3) 


修正 方法 如 下 : 
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lists/forms.py (ch201039-1) 


class NewListForm(ItemForm): 


def save(self, owner): 
if owner.is authenticated: 
return List.create new(first item text-self.cleaned data['text'], owner-owner) 


else: 
return List.create new(first item text-self.cleaned data['text']) 


这 才刚 开始 。 下 面 应 该 看 一 下 占 位 测试 : 
[...] 
FAIL: test create returns new list object 


self.fail() 
AssertionError: None 


FAILED (failures-1, errors-3) 


编写 这 个 测试 : 





lists/tests/test models.py (ch201039-2) 


def test create returns new list object(self): 
returned = List.create new(first item text-'new item text') 
new list = List.objects.first() 
self.assertEqual(returned, new list) 


测试 结果 为 : 


AssertionError: None != «List: List object» 


然后 加 上 返回 值 ; 














lists/models.py (ch201039-3) 


@staticmethod 

def create new(first item text, owner=None): 
list = List.objects.create(owner-owner) 
Item.objects.create(text-first item text, list-list ) 
return list. 


现在 整个 测试 组 件 都 可 以 通过 了 : 


$ python manage.py test lists 


Pessi 
Ran 50 tests in 0.169s 





OK 


23.9 还 缺 一 个 测试 
以 上 就 是 由 测试 驱动 开发 出 来 的 保存 清单 属 主 功能 ， 这 个 功能 可 以 正常 使 用 。 不 过 ， 功 能 
测试 却 无 法 通过 : 

















H 
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$ python manage.py test functional tests.test my lists 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: Reticulate splines 


失败 的 原因 是 有 一 个 功能 没 实现 ， 即 清单 对 象 的 .name 属性 。 这 里 还 可 以 使 用 前 一 章 的 测 
试 和 代码 : 




















lists/tests/test models.py (ch201040) 


def test list name is first item text(self): 
list = List.objects.create() 
Item.objects.create(list-list , text-'first item') 
Item.objects.create(list-list , text-'second item') 
self.assertEqual(list .name, 'first item') 


(再 次 说 明 ， v m 所 以 使 用 ORM 没 问 题 。 你 可 能 想 使 用 驭 件 编写 这 个 测 
试 ， 不 过 这 么 做 没什么 意义 

















lists/models.py (ch20104 1) 
(property 


def name(self): 
return self.item set.first().text 


现在 功能 测试 可 以 通 


$ python manage.py test functional tests.test my lists 





Ran 1 test in 21.428s 


OK 


23.10 清理 : 保留 哪些 整合 测试 
现在 一 切 都 可 以 正常 运行 了 ， 要 删除 一 些 多 余 的 测试 ， 还 要 决定 是 否 保留 以 前 的 整合 测试 。 


23.10.1 删除 表单 层 多 余 的 代码 


可 以 把 以 前 针对 ItemForm 类 中 save 方法 的 测试 删 掉 : 





lists/tests/test forms.py 


--- a/lists/tests/test_forms.py 
+++ b/lists/tests/test forms.py 
@@ -23,14 +23,6 QQ class ItemFormTest(TestCase): 


self.assertEqual(form.errors['text'], [EMPTY_ITEM_ ERROR]) 


- def test form save handles saving to a list(self): 
- list = List.objects.create() 

- form = ItemForm(data-('text': 'do me'}) 

- new item - form.save(for list-list ) 
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- self.assertEqual(new item, Item.objects.first()) 
- self.assertEqual(new item.text, 'do me') 
- self.assertEqual(new item.list, list ) 


对 应 用 的 代码 而 言 ， 可 以 把 forms.py 中 两 个 多 余 的 save 方法 删 掉 : 


lists/forms.py 


--- a/flists/forms.py 

+++ b/lists/forms.py 

QQ -22,11 +22,6 QQ class ItemForm(forms.models.ModelForm): 
self.fields['text'].error messages['required'] - EMPTY ITEM ERROR 

- def save(self, for list): 


- self.instance.list - for list 
- return super().save() 


class NewListForm(ItemForm): 
@@ -52,8 +47,3 QQ class ExistinglistItemForm(ItemForm): 
e.error dict = ('text': [DUPLICATE ITEM ERROR]} 


self. update errors(e) 


- def save(self): 
- return forms.models.ModelForm.save(self) 


23.10.2 ”删除 以 前 实现 的 视图 
现在 ， 可 以 把 以 前 的 new list 视图 完全 删 掉 ， 再 把 new list2 重 命名 为 new list; 


























lists/tests/test views.py 


-from lists.views import new list, new list2 
*from lists.views import new list 


class HomePageTest(TestCase): 

QQ -75,7 +75,7 QQ class NewListViewIntegratedTest(TestCase): 
request - HttpRequest() 
request.user = User.objects.create(email-'aQ(b.com') 
request.POST['text'] = 'new list item' 

- new list2(request) 

* new list(request) 
list = List.objects.first() 
self.assertEqual(list .owner, request.user) 


QQ -91,21 «91,21 @@ class NewListViewUnitTest(unittest.TestCase): 





H 
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def test passes POST data to NewListForm(self, mockNewListForm): 
- new list2(self.request) 
* new list(self.request) 


[.. several more] 


lists/urls.py 


--- a/lists/urls.py 

+++ b/lists/urls.py 

QQ -3,7 +3,7 @@ from django.conf.urls import url 
from lists import views 


urlpatterns - [ 
- url(r'^new$', views.new list2, name-'new list'), 
* url(r'^new$', views.new list, name-'new list'), 
Url(r'^(\d+)/$', views.view list, name-'view list'), 
url(r'^users/(.4)/$', views.my lists, name-'my lists'), 


lists/views.py (ch201047) 


def new list(request): 
form = NewListForm(data-request.POST) 
if form.is valid(): 


list = form.save(owner-request.user) 
[sz 
然后 检查 所 有 测试 是 否 仍 能 通过 : 


OK 


23.10.3 ”删除 视图 层 多 余 的 代码 
最 后 要 决定 保留 哪些 整合 测试 (如果 需 要 保留 的 话 )。 
一 种 方法 是 全 部 删除 ， 让 功能 测试 捕获 集成 问题 。 这 么 做 完全 可 行 。 


不 过 ， 从 前 文 得 知 ， 如 果 在 集成 各 层 时 犯 了 小 错误 ， 整 合 测 试 可 以 提醒 你 。 可 以 保留 部 分 
测试 ， 作 为 完整 性 检查 ， 以 便 得 到 快速 反馈 。 


要 不 就 保留 下 面 这 三 个 测试 吧 : 

















lists/tests/test views.py (ch201048) 


class NewListViewIntegratedTest(TestCase): 


def test can save a POST request(self): 
self.client.post('/lists/new', data-('text': 'A new list item']) 
self.assertEqual(Item.objects.count(), 1) 
new item - Item.objects.first() 
self.assertEqual(new item.text, 'A new list item') 





def 


def 


test for invalid input doesnt save but shows errors(self): 
response = self.client.post('/lists/new', data-('text': ''}) 
self.assertEqual(List.objects.count(), 0) 
self.assertContains(response, escape(EMPTY ITEM ERROR)) 


test list owner is saved if user is authenticated(self): 


user = User.objects.create(email-'a(b.com') 
self.client.force login(user) 


self.client.post('/lists/new', data-('text': 'new item')) 


list = List.objects.first() 
self.assertEqual(list .owner, user) 


如 果 最 终 决定 保留 中 间 层 的 测试 ， 我 认为 这 三 个 不 错 ， 因 为 我 觉得 它们 涵盖 了 大 部 分 集成 





操作 : 测试 了 整个 组 件 ， 从 请 求 直 到 数据 库 ， 而 且 履 盖 了 视图 最 重要 的 三 个 用 例 。 











23.11 总 结 : 什么 时 候 编 写 隔离 
编写 整合 测试 


Django 提供 的 测试 工具 为 快速 编写 整合 测试 提供 了 便利 。 闹 
一 个 存在 于 内 存 中 的 数据 库 ， 运 行 速度 很 快 ， 而 且 在 两 次 涡 























组 件 而 言 也 能 获得 不 错 的 覆盖 度 。 


测试 ， 什 么 时 候 


I 试 运行 程序 能 帮助 我 们 创建 
I 试 之 间 还 能 重建 数据 库 。 使 








用 TestCase 类 和 测试 客户 端 测试 视图 很 简单 ， 可 以 检查 是 否 修改 了 数据 库 中 的 对 象 ， 确 认 
URL 映射 是 否 可 用 ， 还 能 检查 渲染 模板 的 情况 。 这 些 工 具 降 低 了 测试 的 门槛 ， 而 且 对 整个 








但 是 ， 从 设计 的 角度 来 说 ， 这 种 整合 测试 比 不 上 严格 的 单元 测试 和 由 外 而 内 的 TDD， 因 为 





它 没 有 后 者 的 优势 全 面 。 
就 本 章 的 示例 而 言 ， 可 以 比较 一 下 修改 前 后 的 代码 : 


def new_list(request): 
form = ItemForm(data-request.POST) 
if form.is valid(): 
list = List() 
if not isinstance(request.user, AnonymousUser): 
list .owner = request.user 
list .save() 
form.save(for list-list ) 
return redirect(list ) 
else: 


return render(request, 'home.html', ["form": form)) 


def new list(request): 
form = NewListForm(data-request.POST) 
if form.is valid(): 
list = form.save(owner-request.user) 
return redirect(list ) 


return render(request, 'home.html', ['form': form)) 
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如 有 果 想 省 点 儿 事 ， 不 走 隔 离 测 试 这 条 路 ， 你 会 下 功夫 重 构 视 图 函数 吗 ? 我 知道 写作 本 书 草 
稿 时 我 不 会 。 我 希望 自己 在 真实 的 项 目 中 会 这 么 做 ， 但 也 不 能 保证 。 可 是 编写 隔离 测试 却 
让 你 看 清 代 码 复杂 在 何 处 。 


23.11.1 以 复杂 度 为 准则 
不 得 不 说 ， 处 理 复杂 问题 时 才能 体现 隔离 测试 的 优势 。 本 书 中 的 例子 非常 简单 
得 这 么 做 。 就 算是 本 章 的 例子 ， 我 也 能 说 服 自己 ， 完 全 不 用 编写 这 些 隔离 测试 。 


可 一 旦 应 用 变 得 复杂 ， 比 如 视图 和 模型 之 间 分 了 更 多 层 、 需 要 编写 辅助 方法 或 自己 的 类 ， 
那 多 编写 一 些 隔离 测试 或 许 就 能 从 中 受益 了 。 


23.11.2 ”两 种 测试 都 要 写 吗 

功能 测试 组 件 能 告诉 我 们 集成 各 部 分 代码 时 是 否 有 问题 。 隔 离 测 试 能 帮助 我 们 设计 出 更 好 
的 代码 ， 还 能 验证 细节 的 处 理 是 否 正 确 。 那 么 中 间 层 集成 测试 还 有 其 他 作用 吗 ? 

我 想 ， 如 果 集 成 测试 能 更 快 地 提供 反馈 ， 或 者 能 更 精确 地 找 出 集成 问题 的 原因 所 在 ， 那 
么 答案 就 是 肯定 的 。 集 成 测试 的 优势 之 一 是 ， 它 在 调用 跟踪 中 提供 的 调试 信息 比 功能 测 
试 详细 。 
甚至 还 可 以 把 各 组 件 分 开 可 以 编写 一 个 速度 快 、 隔 离 的 单元 测试 组 件 ， 完 全 不 用 
manage.py， 因 为 这 些 测 试 不 需要 Django 测试 运行 程序 提供 的 任何 数据 库 清理 操作 。 然 后 
使 用 Django 提供 的 工具 编写 中 间 层 测试 ， 最 后 使 用 功能 测试 检查 与 过 渡 服 务 器 交互 的 各 
层 。 如 果 各 层 提供 的 功能 循序 渐进 ， 或 许 就 可 以 采用 这 种 方案 。 

到 底 怎么 做 ， 要 根据 实际 情况 而 定 。 我 希望 读 过 这 一 章 之 后 ， 你 能 体会 到 如 何 权衡 。 第 26 
章 会 继续 讨论 这 个 话题 。 














还 不 太 值 

























































































23.11.3 ”继续 前 行 
对 新 版 代码 很 满意 ， 那 就 合并 到 主 分 支 吧 ; 


$ git add . 

$ git commit -m "add list owners via forms. more isolated tests" 
$ git checkout master 

$ git checkout -b master-noforms-noisolation-bak # 也 可 以 做 个 备份 
$ git checkout master 

$ git reset --hard more-isolation # 把 主 分 支 重 设 到 这 个 分 支 


现在 ， 运 行 功 能 测试 要 花 很 长 时 间 ， 我 想 知道 我 们 能 不 能 做 些 什 么 来 改善 这 种 状况 。 
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不 同 测 试 类 型 以 及 解 而 ORM (C838 S5 

功能 测试 

。 从 用 户 的 角度 出 发 ， 最 大 程度 上 保证 应 用 可 以 正常 运行 。 

。 但 是 ， 反 馈 循环 用 时 长 。 

。 无 法 帮助 我 们 写 出 简洁 的 代码 。 
整合 测试 (依赖 于 ORM X Django WRP HF) 

。 编写 速度 快 。 

。 易于 理解 。 

。 发 现任 何 集成 问题 都 会 提醒 你 。 

。 但 是 ， 并 不 总 能 得 到 好 的 设计 (这 取决 于 你 自己 )。 

。 一 般 运行 速度 比 隔离 测试 慢 。 
隔离 测试 (使 用 驭 件 ) 

。 涉及 的 工作 量 最 大 。 

。 可 能 难以 阅读 和 理解 。 

。 但 是 ， 这 种 测试 最 能 引导 你 实现 更 好 的 设计 。 

。 运行 速度 最 快 。 


解 耦 应 用 代码 和 ORM 代码 


力求 隔离 测试 的 后 果 之 一 是 ， 我 们 不 得 不 从 视图 和 表单 等 处 删除 ORM 代码 ， 把 它 
们 放 到 辅助 函数 或 者 辅助 方法 中 。 如 果 从 解 辜 应 用 代码 和 ORM 代码 的 角度 看 ， 这 


么 做 有 好 处 ， 还 能 提高 代码 的 可 读 性 。 当 然 ， 所 有 事情 都 一 样 ， 要 


断 是 否 值得 付出 额外 精力 去 做 。 


实际 情况 判 
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持续 集成 


网 站 越 变 越 大 ， 运 行 所 有 功能 测试 的 时 间 也 越 来 越 长 。 如 果 时 长 一 直 增 加 ， 我 们 很 可 能 不 


再 运行 功能 测试 。 





为 了 避免 发 生 这 种 情况 ， 可 以 搭建 一 个 “持续 集成 ”(Continuous Integration， 简 称 CI) Hk 
务 器 ， 自 动 运 行 功能 测试 。 这 样 ， 在 日 常 开发 中 ， 只 需 运 行当 下 关注 的 功能 测试 ， 整 个 测 
试 组 件 则 交 给 CI 服务 器 自动 运行 。 如 果 不 小 心 破坏 了 某 项 功能 ，CI 服 务 器 会 通知 我 们 。 

















单元 测试 的 运行 速度 一 直 很 快 ， 每 隔 儿 秒 就 可 以 运行 一 次 。 
现在 ， 开 发 者 喜欢 使 用 的 CI 服务 器 是 Jenkins。 


Jenkins 使 用 Java 开发 ， 经 常 出 问题 ， 界 面 





也 不 漂亮 ,但 大 家 都 在 用 ， 而 且 插 件 系 统 很 棒 ， 下 面 安 装 并 运行 Jenkins。 








24.1 安装 Jenkins 











CI 托管 服务 有 很 多 ， 基 本 上 都 提供 了 一 个 立即 就 能 使 用 的 Jenkins 服务 器 。 我 知道 的 就 有 
Sauce Labs, Travis, Circle-CI 和 ShiningPanda， 可 能 还 有 更 多 。 假 设 要 在 自己 有 控制 权 的 


服务 器 上 安装 所 需 的 一 切 软件 。 


把 Jenkins 安装 在 过 滤 服 务 器 或 生产 服务 器 上 可 不 是 个 好 主意 ， 因 为 有 很 多 
操作 要 交 给 Jenkins 完成 ， 比 如 重新 引导 过 渡 服 务 器 。 


要 从 Jenkins 的 官方 apt 仓库 中 安装 最 新 版 ， 








因为 Ubuntu 默认 安装 的 版 本 对 本 地 化 和 





Unicode 支持 还 有 些 恼人 的 问题 ， 而 且 默 认 配 置 也 没 监 听 外 网 : 
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rootQserver:$ wget -q -0 - https://pkg. jenkins.io/debian/jenkins-ci.org.key |\ 
apt-key add - 

rootüserver:$ echo deb http://pkg.jenkins.io/debian-stable binary/ | tee V 
/etc/apt/sources.list.d/jenkins.list 

rootQserver:$ apt-get update 

rootQserver:$ apt-get install jenkins 


(这 是 从 Jenkins 网 站 上 查 到 的 安装 说 明 。) 
此 外 还 要 安装 儿 个 依赖 : 
root@server:$ apt-get install firefox python3-venv xvfb 


# 以 及 构建 fabric3 所 需 的 依赖 
root@server:$ apt-get install build-essential libssl-dev libffi-dev 


我 们 还 要 下 载 、 解 压 和 安装 geckodriver (我 写 到 这 里 时 ， 版 本 为 v0.17; 你 阅读 时 ， 记 得 
换 成 最 新 版 ): 


root@server:$ wget https://github.com/mozilla/geckodriver/releasesY 
/download/v0.17.0/geckodriver-v0.17.0-linux64.tar.gz 

rootüserver:$ tar -xvzf geckodriver-v0.17.0-linux64.tar.gz 
rootüserver:$ mv geckodriver /usr/local/bin 

rootQserver:$ geckodriver --version 

geckodriver 0.17.0 








增加 一 些 交 换 内 存 
Jenkins 是 内 存 消 耗 大 户 。 如 果 在 RAM 很 小 的 虚拟 主机 上 和 运行， 会 由 于 内 存 不 足 而 裔 
渍 。 这 时 ， 要 增加 一 些 交换 内 存 : 
$ fallocate -l 4G /swapfile 
$ mkswap /swapfile 


$ chmod 600 /swapfile 
$ swapon /swapfile 


这 样 内 存 就 充足 了 。 











24.2 配置 Jenkins 


现在 可 以 访问 服务 器 的 URL/IP， 通 过 8080 端口 访问 Jenkins， 你 会 看 到 如 图 24-1 所 示 的 
界面 。 
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Jenkins [Jenkins] - Mozilla Firefox x 











Ja Jenkins [Jenkins] x M 
€) © f | 46.101.42.146:8080/login?from-?£2F | G | [& Search | * 6 & 全 >» 














Getting Started 


Unlock Jenkins 


To ensure Jenkins is securely set up by the administrator, a 
password has been written to the log (not sure where to find it?) and 
this file on the server: 


/var/lib/jenkins/secrets/initialAdminPassword 


Please copy the password from either location and paste it below. 


Administrator password 











24-1; Jenkins 解锁 界面 


24.0.4 首次 解锁 
解锁 界面 告诉 我 们 ， 首 次 使 用 时 要 从 磁盘 中 读 取 一 个 文件 ， 解 锁 服务 器 。 切 换 到 终端 ， 使 
用 下 述 命令 打印 那个 文件 的 内 容 : 


root@server$ cat /var/lib/jenkins/secrets/initialAdminPassword 


24.2.2 ”现在 建议 安装 的 插件 


接 下 来 会 让 你 选择 安装 “推荐 的 ”插件 。 系 统 推荐 的 插件 还 不 错 。( 作 为 自尊 心 强 的 技术 
宅 ， 我 们 会 本 能 地 点 击 “ 自 定义 "”。 一 开始 我 也 是 这 么 做 的 ， 但 是 自 定义 界面 也 没什么 。 
别 担心 ， 稍 后 会 再 添加 一 些 插件 。) 


24.2.3 配置 管理 员 用 户 


接 下 来 ， 设 置 登录 Jenkins 的 用 户 名 和 密码 ， 如 图 24-2 所 示 。 
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SetupWizard [Jenkins] - Mozilla Firefox x 





B £à SetupWizard [Jenkins] x Ve i 








(€) G & | 46.101.42.146:8080 


je ] [® Search 





eO t>» 三 











Jenkins 2.32.2 





Getting Started 


Create First Admin User 


Username: 
Password: 
Confirm password: 
Full name: 


E-mail address: 


Continue as admin Save and Finish 





24-2. Jenkins 管理 员 用 户 配置 界面 


登录 后 会 看 到 一 个 欢迎 界 1 








| (如 





IRİ 








IT 








24-3 所 示 ) 。 





Dashboard [Jenkins] - Mozilla Firefox 





/ à Dashboard [Jenkins] 


(€) © | 46.101.42.146:8080 


b Jenkins 


Jenkins 


r New Item 

& People 

€ Build History 
党 Manage Jenkins 
& My Views 

WA. Credentials 


Build Queue 


No builds in the queue. 





C ||C? Search 





C + 8 


ENABLE AUTO REFRESH 


(Hadd description 


Welcome to Jenkins! 


Please create new jobs to get started. 








图 24-3: 看 到 一 个 男 仆 (左上 角 )， 好 奇怪 
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24.2.4 添加 插件 


依次 点 击 这 些 链 接 : Manage Jenkins (管理 Jenkins) 一 Manage Plugins (管理 插件 ) 
Available (可 用 插件 )。 


我 们 将 安装 下 述 插件 : 








ShiningPanda 
Xvfb 


点 击 “Install”( 如 图 24-4 所 示 ) 。 


— 














Update Center [Jenkins] - Mozilla Firefox e 
File Edit View History Bookmarks Tools Help 
| G Update Center [Jenkins] | [5 
€ @ jenkins.ottg.eu:8080/updateCenter/ "© B- Google Q $ A Xr 





Jenkins pi 1H 





Jenkins Update center ENABLE AUTO REFRESH 


k boa! 
f ses ^ Installing Plugins/Upgrades 
P Manage Jenkins 
Preparation 


Manage Plugins * Checking internet connectivity 

* Checking update center connectivity 

* Success 
Credentials Plugin Downloaded Successfully. Will be activated during the next boot 
SSH Credentials Plugin Downloaded Successfully. Will be activated during the next boot 
Git Client Plugin Installing 

n———. | 

SCM API Plugin @ Pending 
Git Plugin @ Pending 
Xvfb Plugin Qo Pending 


ShiningPanda Plugin o Pending 


C Go back to the top page 
(you can start using the installed plugins right away) 





Wi» (7 Restart lenkins when installatinn is cnmolete And no inh are runninn Ie 











O- x se 











24-4, 安装 插件 中 …… 


24.2.5 告诉 Jenkins 到 哪里 寻找 Python 3 和 Xvfb 


我 们 要 告诉 ShiningPanda 插件 ，Python 3 安装 在 哪里 (通常 是 /usr/bin/python3， 不 过 也 可 
以 执行 which python3 命令 查看 )。 


。 Manage Jenkins (管理 Jenkins) 一 Global Tool Configuration (全 局 工具 配置 )。 


* Python — Python installations (Python 安装 位 置 ) 一 Add Python (添加 Python， 如 


24-5 所 示 ; 可 以 放心 忽略 提醒 消息 ) o 








zs 
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e  Xvfbinstallation (Xvfb 安装 位 置 ) 一 Add Xvfb installation (添加 Xvfb 安装 位 置 ) ， 在 安 
装 目录 中 输入 /usr/bin。 








Python 
Python installations Python 


Name python3 e 


Home or executable Just/bin/python3 e 


lusr/bin/python3 is not a directory on the Jenkins master (but 
> perhaps it exists on some agents) 











图 24-5; Python 安装 在 哪里 


24.2.6 设置 HTTPS 

为 了 提升 Jenkins 的 安全 性 ， 最 后 还 要 设置 HTTPS。 为 此 ， 我 们 将 让 Nginx 使 用 自 签名 的 
证 书 ， 把 发 给 443 端口 的 请 求 转发 给 8080 端口 。 这 样 设置 之 后 ， 甚 至 可 以 让 防火 墙 阻 断 
8080 端口 。 有 具体 设置 方法 这 里 不 详细 讨论 ， 你 可 以 参照 下 述 链接 给 出 的 说 明 。 

。 Jenkins 官方 的 Ubuntu 安装 指南 。 

。 如 何 创建 自 签名 SSL 证 书 。 

。 如 何 把 HTTP 重 定向 到 HTTPS, 


24.3 RAMH 


现在 Jenkins 基本 配置 好 了 ， 下 面 设置 项 目 。 

。 点 击 “New Item” t. 

。 名 称 输入 “Superlists”， 选 择 “Freestyle project”， 然 后 点 击 “OK”。 
。 添加 Git 仓库， 如 图 24-6 所 示 。 
































Source Code Management 
6 cit 
Repositories Repository URL [httos://github.com/hjwp/book-example.git e e 
Credentials - none - = 
| Advanced... | 





Add Repository || Delete Repository | 














24-6: 从 Git 仓库 中 获取 源码 
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。 设 为 每 小 时 轮 询 一 次 (如 图 24-7， 看 一 下 帮助 文本 ， 触 发 构建 操作 还 有 很 多 其 他 方式 ) 。 








图 pollsCM e 
Schedule Heers 2) 


This Field Follows the syntax of cron (with minor differences). Specifically, each line consists of 5 fields separated 
by TAB or whitespace: 
MINUTE HOUR DOM MONTH DOW 


MINUTE Minutes within the hour (0-59) 
HOUR The hour of the day (0-23) 
DOM The day of the month (1-31) 
MANTH The mnnth (1-121 











24-7; 轮 询 GitHub， 获 取 改 动 


。 在 一 个 Python 3 虚拟 环境 中 运行 测试 。 
。 单元 测试 和 功能 测试 分 开 运 行 ， 如 图 24-8 所 示 。 








Build 
Virtualenv Builder 
Python version | Python-3 n 
Clear mM 


Nature Shell a 


© 0000 


Command 





| Advanced | 











24-8: 虚拟 环境 中 执行 的 构建 步骤 


24.4 ”第 一 次 构建 


点 击 “Build Now” (现在 构建 ) 按钮 ， 然 后 查看 “Console Output” (终端 输出 ) ， 应 该 会 看 
到 类 似 下 面 的 内 容 : 


Started by user harry 

Building in workspace /var/lib/jenkins/jobs/Superlists/workspace 

Fetching changes from the remote Git repository 

Fetching upstream changes from https://github.com/hjwp/book-example.git 
Checking out Revision d515acebf7ei173f165ce713b30295a4a6ee17c07 (origin/master) 
[workspace] $ /bin/sh -xe /tmp/shiningpanda7260707941304155464.sh 

* pip install -r requirements.txt 

Requirement already satisfied (use --upgrade to upgrade): Django--1.11 in 








有 


p 





/var/lib/jenkins/shiningpanda/jobs/ddc1aed1/virtualenvs/d41d8cd9/lib/python3.3/ 
site-packages 
(from -r requirements.txt (line 1)) 


Requirement already satisfied (use --upgrade to upgrade): gunicorn==17.5 in 

/var/lib/jenkins/shiningpanda/jobs/ddc1aed1/virtualenvs/d41d8cd9/lib/python3.3/ 

site-packages 

(from -r requirements.txt (line 3)) 

Downloading/unpacking requests==2.0.0 (from -r requirements.txt (line 4)) 
Running setup.py egg_info for package requests 


Installing collected packages: requests 
Running setup.py install for requests 


Successfully installed requests 
Cleaning up... 
+ python manage.py test lists accounts 


Ran 67 tests in 0.429s 


OK 

Creating test database for alias 'default'... 
Destroying test database for alias 'default'... 
* python manage.py test functional tests 
EEEEEE 


InportError: Failed to import test module: functional, tests.test, layout and styling 
iu c No module named 'selenium' 

Ran 6 tests in 0.001s 

FAILED (errors-6) 


Build step 'Virtualenv Builder' marked build as failure 


于， 在 虚拟 环境 中 要 安装 Selenium, 
在 构建 步 又 中 添加 一 步 ， 手 动 安装 Selenium: 


pip install -r requirements.txt 

python manage.py test accounts lists 
pip install selenium 

python manage.py test functional tests 


有 些 人 喜欢 使 用 test-requirements.txt 文件 指定 测试 〈 不 是 主 应 用 ) 需要 的 包 。 
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然后 再 次 点 击 “Build Now" (现在 构建 ) 按钮 。 
接 下 来 会 发 生 下 面 两 件 事 中 的 一 件 。 你 可 能 会 看 到 控制 台 输出 了 类 似 这 样 的 错误 消息 : 


self.browser = webdriver.Firefox() 

| Wy 

selenium.common.exceptions.WebDriverException: Message: 'The browser appears to 

have exited before we could connect. The output was: b"\\n(process:19757): 

GLib-CRITICAL **: g slice set config: assertion V'sys page size == 0V' 

failed VAnError: no display specifiedWn" ' 

[s] 

selenium.common.exceptions.WebDriverException: Message: connection refused 
也 可 能 构建 完全 挂 起 (我 至 少 遇 到 过 一 次 )。 出 现 这 种 情况 的 原因 是 Firefox 无 法 启动 ， 
为 没有 显示 器 可 用 。 


24.5 “设置 虚拟 显示 器 ， 让 功能 测试 能 在 无 界面 的 
环境 中 运行 
从 调用 跟踪 中 可 以 看 出 ，Firefox 无 法 启动 ， 因 为 服务 器 没有 显示 器 。 


这 个 问题 有 两 种 解决 方法 。 第 一 种 ， 换 用 无 界面 浏览 器 (headless browser) ， 例 如 PhantomJS 
或 SlimerJS。 这 种 工具 绝对 有 存在 的 意义 ， 最 大 的 特点 是 运行 速度 快 ， 但 也 有 缺点。 首先 ， 
它们 不 是 “真正 的 ”Web 浏览 器 ， 所 以 无 法 保证 能 捕获 用 户 使 用 真正 的 浏览 器 时 遇 到 的 全 部 
怪异 行为 。 其 次 ， 它 们 在 Selenium 中 的 表现 差异 很 大 ， 因 此 要 花费 大 量 精力 重 写 功能 测试 。 








>H 



































只 把 无 界面 浏览 器 当 作 开 发 工具 ， 目 的 是 在 开发 者 的 设备 中 提升 功能 测试 
的 运行 速度 。 在 CI 服务 器 上 运行 测试 则 使 用 真正 的 浏览 器 。 











第 二 种 解决 方法 是 设置 虚拟 显示 器 : 让 服务 器 认为 自己 连接 了 显示 器 ， 这 样 Firefox 就 能 
正常 运行 了 。 这 种 工具 很 多 , 我 们 要 使 用 的 是 “Xvfb”(X Virtual Framebuffer) ', 因为 它 安装 
和 使 用 都 很 简单 ， 而 且 还 有 一 个 合用 的 Jenkins 插件 (现在 知道 为 什么 之 前 要 安装 它 了 吧 )。 
回 到 项 目 页 面 ， 点 击 “Configure”( 配 置 )， 找 到 “Build Environment”( 构 建 环境 ) 部 分 。 
启用 虚拟 显示 器 的 方法 很 简单 ， 勾 选 “Start Xvfb before the build, and shut it down after" 
(构建 前 启动 Xvfb， 并 在 构建 完成 后 关闭 ) 即 可 ， 如 图 24-9 所 示 。 




















Ed: 如 果 想 在 Python 代码 中 控制 虚拟 显示 器 ， 可 以 试 试 pyvirtualdisplay 。 








354 | 第 24 章 








Ignore post-commit hooks 


Build Environment 





图 start Xvfb before the build, and shut it down after. 





Virtualenv Ruilder 


24-9. 有 时 配置 方式 很 简单 


现在 构建 过 程 顺利 多 了 : 

[2s 
Xvfb starting$ /usr/bin/Xvfb :2 -screen © 1024x768x24 -fbdir 
[var /lib/jenkins/2013-11-04 03-27-221510012427739470928xvfb 
[ss] 


+ python manage.py test lists accounts 








Ran 63 tests in 0.410s 


OK 
Creating test database for alias 'default'... 
Destroying test database for alias 'default'... 


* pip install selenium 

Requirement already satisfied (use --upgrade to upgrade): selenium in 
[var/lib/jenkins/shiningpanda/jobs/ddciaedi1/virtualenvs/d41d8cd9/lib/python3.5/ 
site-packages 

Cleaning up... 


* python manage.py test functional tests 


FAIL: test can start a list for one user 
(functional tests.test simple list creation.NewVisitorTest) 
Traceback (most recent call last): 
File "/.../superlists/functional tests/test simple list creation.py", line 
43, in test can start a list for one user 
self.wait for row in list table('2: Use peacock feathers to make a fly') 
File "/.../superlists/functional tests/base.py", line 51, in 
wait for row in list table 
raise e 
File "/.../superlists/functional tests/base.py", line 47, in 
wait for row in list table 
self.assertIn(row text, [row.text for row in rows]) 
AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Buy 
peacock feathers'] 
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Ran 8 tests in 89.275s 


FAILED (errors-1) 

Creating test database for alias 'default'... 

[f'secure': False, 'domain': 'localhost', 'name': 'sessionid', 'expiry': 
1920011311, 'path': '/', 'value': 'a8d8bbde33nreq6gihw8a7ricc8bf02k')] 
Destroying test database for alias 'default'... 

Build step 'Virtualenv Builder' marked build as failure 

Xvfb stopping 

Finished: FAILURE 


就 快 成 功 了 ! 为 了 调试 错误 ， 还 需要 截图 。 











这 个 错误 是 由 于 我 的 Jenkins 性 能 不 足 ， 所 以 不 一 定 总 会 出 现 。 你 可 能 会 
到 不 同 的 错误 ， 或 者 根本 没 错误 。 不 管 怎样 ， 下 面 介绍 的 截图 工具 和 处 理 条 
件 竞争 的 工具 总 有 一 天 会 用 到 。 继 续 读 吧 ! 


























24.6 截图 


为 了 调试 远程 设备 中 意料 之 外 的 失败 ， 最 好 能 看 到 失败 时 的 屏幕 图 片 ， 或 者 还 可 以 转 储 页 




















MAJ HTML。 这 些 操作 可 在 功能 测试 类 中 的 tearDown 方法 里 自 定义 逻辑 实现 。 为 此 ， 要 深 





入 unittest 的 内 部 ， 使 用 私有 属性 _outcomeForDoCleanups， 不 过 像 下面 这 样 写 也 行 : 











functional tests/base.py (ch211006) 


import os 
from datetime import datetime 


MN 


SCREEN, DUMP. LOCATION = os.path.join( 
os.path.dirname(os.path.abspath( file )), 'screendumps' 
) 


[...] 


def tearDown(self): 
if self. test has failed(): 
if not os.path.exists(SCREEN DUMP LOCATION): 
os.makedirs(SCREEN DUMP. LOCATION) 
for ix, handle in enumerate(self.browser.window handles): 
self. windowid = ix 
self.browser.switch to window(handle) 
self.take screenshot() 
self.dump html() 
self.browser.quit() 
super().tearDown() 


def test has failed(self): 
# 有 点 令 人 费解 ， 但 我 找 不 到 更 好 的 方法 了 


return any(error for (method, error) in self. outcome.errors) 


Tr. X SXEIBEGUEE EGRE Hoe. Amn, WMAP AA axe RUD, WHE 
Selenium 提供 的 方法 (get screenshot as file f[Ibrowser.page source) 截图 以 及 转 储 HTML: 

















functional tests/base.py (ch211007) 


def take screenshot(self): 
filename = self. get filename() + '.png 
print('screenshotting to', filename) 
self.browser.get screenshot as file(filename) 


1 1 


def dump html(self): 
filename = self. get filename() + '.html' 
print('dumping page HTML to', filename) 
with open(filename, 'w') as f: 
f.write(self.browser.page source) 


最 后 ， 使 用 一 种 方式 生成 唯一 的 文件 名 标识 符 。 文 件 名 中 包括 测试 方法 和 测试 类 的 名 字 ， 
以 及 一 个 时 间 惟 : 

















functional tests/base.py (ch211008) 


def get filename(self): 

timestamp - datetime.now().isoformat().replace(':', '.')[:19] 

return '(folderj/(classname].[method) -window(windowid]-([timestamp)'.format( 
folder-SCREEN DUMP LOCATION, 
classname-self. class . name , 
method-self. testMethodName, 
windowid-self. windowid, 
timestamp-timestamp 


) 
可 以 先 在 本 地 测试 一 下 ， 故 意 让 某 个 测试 失败 ， 例 如 使 用 setf.fatL()， 会 看 到 类 似 下 面 
的 输出 : 
[...] 


screenshotting to /.../superlists/functional tests/screendumps/MyListsTest.test 
. logged in users lists are saved as my lists-window0-2014-03-09T11.19.12.png 
dumping page HTML to /.../superlists/functional tests/screendumps/MyListsTest.t 
est logged in users lists are saved as my lists-window0-[...] 




















删 掉 self.fail()， 然 后 提交 ， 再 推送 : 


$ git diff # 显示 base.py 中 的 改动 
$ echo "functional tests/screendumps" »» .gitignore 
$ git commit -am "add screenshot on failure to FT runner" 


$ git push 
在 Jenkins 中 重新 构建 时 ,会 看 到 类 似 下 面 的 输出 : 


screenshotting to /var/lib/jenkins/jobs/Superlists/.../functional tests/ 
screendumps/LoginTest.test login with persona-window0-2014-01-22T17.45.12.png 
dumping page HTML to /var/lib/jenkins/jobs/Superlists/.../functional tests/ 
screendumps/LoginTest.test login with persona-window0-2014-01-22T17.45.12.html 




















可 以 在 “工作 空间 ”中 查看 这 些 文件 。 工 作 空 间 是 Jenkins 用 来 存储 源码 以 及 运行 测试 所 
在 的 文件 夹 ， 如 图 24-10 所 示 。 
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Superlists chapter 17 workspace : / [Jenkins] - Mozilla Firefox e 
File Edit View History Bookmarks Tools Help 
Q Superlists chapter 17 workspa... Í an 

€ 》 @ jenkins.ottg.eu:8080/job/S "© | 图 > Google Q iL [^] X 

x 

Jenkins D hary llogout 
Jenkins Superlists chapter 17 ENABLE AUTO REFRESH 

会 Back to Dashboard a» 

Q) Status 

EÈ Changes 

E Workspace 

B Wipe Out Current Workspace 

(&) suia Nov 

Delete Project E 

© — [E] distribute-0.6.34.tar.az t 

六 Contoure 
[E] manage.py 
ii Git Poling Log 
[E] reauirements.txt 
$9) Build History trend! 
TP [E] seleniumhtm-MyListsTesttest logged in users lists are saved as my lists- 
Nov 6. 2013 5:11:33 AM 

和 2013-11-05T08.09.20.012683.html 

@ #10 NovS. 2013 9:49:31AM [E] seleniumscreenshot-MyListsTest.test logged in users lists are saved as my lists- 

@ ho Növ 5.2013 9:13:03 AM 2013-11-05T08.09.19.955864.png 

@ #6 Nov 5.2013 9:07:26 AM f (al fies in zip) x 
locale | ^iv Highlight All MatchCase X 
O- x se 

















图 24-10: 访问 项 目的 工作 空间 
然后 查看 截图 ， 如 图 24-11 所 示 。 








seleniumscreenshot-MyListsTest.test logged in users lists are saved as my lists-2013-11-05T08.09.19.9558 Œ 
File Edit View History Bookmarks Tools Help 
| seleniumscreenshot-MyListsT... (de 


< [e 





jenkins.ottg.eu:80 





Google QI i e x 


Superlists My lists Logged in as edith@email.com Log out 


My lists 


edith@email.com's lists 


* Reticulate splines 





locale ajy Highlight All MatchCase % 
O- x 5 ® 














& 24-11: 截图 看 起 来 正常 
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24.7 ”如 有 疑问 ， 增 加 超时 试 试 
JB, 显然 没什么 线索 。 老 话说 得 好 ， 如 有 疑问 ， 增 加 超时 : 
functional tests/base.py 
MAX_WAIT = 20 


然后 在 Jenkins 中 点 击 “Buid now”( 现 在 构建 )， 再 次 构建 ， 确 认 测 试 是 否 能 通过 ， 如 图 
24-12 所 示 。 


























| Superlists [Jenkins] - Mozilla Firefox x 
File Edit View History Bookmarks Tools Help 

| à superlists [Jenkins] E] 

€ È |@ jenkins.ottg.eu:8080/view/superlists » @| |H Google a L 合 Xx 


Jenkins COE o o oo G 


Jenkins Superiists ENABLE AUTO REFRESH 
[add description 





SW New Job 

二 

Al | Superlists | + 
P: le 

& ee S W Name 1 Last Success Last Failure — Last Duration 

TÈ Bui History. ^ 

a o ^.^ Superistschapteri7 ^ 8min29sec-fi3 23hr-i9 1 min 15 sec. D 
Edit View - 

kon: SML 

© peete vew ~- Legend 国 Bssforal G) ASS tor taiures S} ASS for iust latest buids 





Manage Jenkins 
£ Manage Jenkins 
Â Credentials 

& views 

Build Queue 

No builds in the queue. 


Build Executor Status 
* Status 

1 dde 

2| ide 


Wi Heb us ocalize this page Page generated: Nov 6, 2013 8:24:33 AM 
0- x se 








REST API Jenkins ver. 1538 |J 




















图 24-12. 前 景 更 明朗 


Jenkins 使 用 蓝 色 表示 构建 成 功 。 居 然 没 用 绿色 ， 真 让 人 失望 。 不 过 看 到 太阳 从 云 中 探 出 头 
来 ， 心 情 又 舒畅 了 。 这 个 图 标 表 示 成 功 构 建 和 失败 构建 的 平均 比值 正在 发 生变 化 ， 而 且 是 
向 好 的 一 面 发 展 。 


24.8 使 用 PhantomJS 运 行 QUnit JavaScript 测 试 


差点 儿 忘 了 还 有 一 种 测试 JavaScript 测试 。 现 在 的 “测试 运行 程序 ”是 真正 的 Web 浏 
览 器 。 若 想 在 Jenkins 中 运行 JavaScript 测试 ， 需 要 一 种 命令 行 测试 运行 程序 。 借 此 机 会 使 
用 PhantomJS , 





























24.8.1 安装 node 


别 再 假装 用 不 到 JavaScript T, fü Web 开发 ， 离 不 开 它 。 因 此 ， 要 在 自己 的 电脑 中 安装 
node.js， 这 一 步 不 可 避免 。 


T 
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安装 方法 参见 node.js 下 载 页 面 中 的 说 明 。Windows fll Mac 系统 都 有 安装 包 ， 而 且 各 种 流 
行 的 Linux 发 行 版 都 有 各 自 的 包 ”。 


安装 好 node Zia, PLAP 





行 下 面 的 命令 安装 PhantomJS : 


rootQserver $ npm install -g phantomjs # -9 的 意思 是 系统 全 局 安装 


接 下 来 要 下 载 QUniVPhantomJS 测试 运行 程序 。 测 试 运行 程序 有 很 多 (为 了 运行 本 书 中 
的 QUnit 测试 ， 我 甚至 还 自己 写 过 一 个 简单 的 )， 不 过 最 好 使 用 QUnit 插件 页 面 提 到 的 那 


个 


runner。 只 需要 一 个 文件 ， 




















个 。 写 作 本 书 时 ， 这 个 运行 程序 的 仓库 地 址 是 https://github.com/jonkemp/qunit-phantomjs- 


Tunner.jS。 


最 终 得 到 的 文件 夹 结构 如 下 : 


$ tree lists/static/tests/ 


lists/static/tests/ 
I— qunit-2.0.1.css 
I— qunit-2.0.1.js 
I— runner.js 
L— tests.html 


0 directories, 4 files 


试 一 下 这 个 运行 程序 ; 


$ phantomjs lists/static/tests/runner.js lists/static/tests/tests.html 
Took 24ms to run 2 tests. 2 passed, 0 failed. 


保险 起 见 ， 故 意 破坏 一 个 测试 : 


lists/static/list.js (ch211019) 


$('input[name-2"text"]').on('keypress', function () { 


// SC' .has-error' 
DH 


有 果然， 测试 失败 了 : 


).hideO; 


$ phantomjs lists/static/tests/runner.js lists/static/tests/tests.html 


Test failed: errors should be hidden on keypress 


Failed assertion: 


expected: false, but was: true 


file:///.../superlists/lists/static/tests/tests.html:27:15 


Took 27ms to run 2 tests. 1 passed, 1 failed. 


很 好 ! 再 改 回去 ， 提 交 并 推送 运行 程序 ， 然 后 将 其 添加 到 Jenkins 的 构建 步骤 中 : 


Ax LT UY LT 


git push 








git checkout lists/static/list.js 
git add lists/static/tests/runner.js 
git commit -m "Add phantomjs test runner for javascript tests" 





注 2; 一 定 要 下 载 最 新 版 。 在 Ubuntu 中 别 用 默认 的 包 ， 要 使 用 PPA。 











E 
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24.8. ”在 Jenkins 中 添加 构建 步骤 


再 次 编辑 项 目 配置 ， 为 每 个 JavaScript 测试 文件 添加 一 个 构建 步骤 ， 如 图 24-13 所 示 。 














Execute shell 


Command [pr 





See fe Est of available environment variables 














24-18; 为 JavaScript 单元 测试 添加 构建 步骤 


还 要 在 服务 器 中 安装 PhantomJS : 


root@server:$ add-apt-repository -y ppa:chris-lea/node.js 
root@server:$ apt-get update 

rootQserver:$ apt-get install nodejs 

root@server:$ npm install -g phantomjs 


至 此 ， 编 写 了 完整 的 CI 构建 步骤 ， 能 运行 所 有 测试 ! 


Started by user harry 

Building in workspace /var/lib/jenkins/jobs/Superlists/workspace 

Fetching changes from the remote Git repository 

Fetching upstream changes from https://github.com/hjwp/book-example.git 

Checking out Revision 936a484038194b289312ff62f10d24e6a054fb29 (origin/chapter 1 
Xvfb starting$ /usr/bin/Xvfb :1 -screen © 1024x768x24 -fbdir /var/lib/jenkins/20 
[workspace] $ /bin/sh -xe /tmp/shiningpanda7092102504259037999.sh 


* pip install -r requirements.txt 


[...] 


+ python manage.py test lists 


Ran 43 tests in 0.229s 


OK 
Creating test database for alias 'default'... 
Destroying test database for alias 'default'... 


* python manage.py test accounts 


Ran 18 tests in 0.078s 


OK 
Creating test database for alias 'default'... 
Destroying test database for alias 'default'... 


[workspace] $ /bin/sh -xe /tmp/hudson2967478575201471277.sh 

* phantomjs lists/static/tests/runner.js lists/static/tests/tests.html 
Took 32ms to run 2 tests. 2 passed, 0 failed. 

* phantomjs lists/static/tests/runner.js accounts/static/tests/tests.html 
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Took 47ms to run 11 tests. 11 passed, 0 failed. 


[workspace] $ /bin/sh -xe /tmp/shiningpanda7526089957247195819.sh 
* pip install selenium 
Requirement already satisfied (use --upgrade to upgrade): selenium in /var/lib/ 


Cleaning up... 
[workspace] $ /bin/sh -xe /tmp/shiningpanda2420240268202055029.sh 
* python manage.py test functional tests 


Ran 8 tests in 76.804s 
OK 


如 果 我 太 懒 ， 不 想 在 自己 的 设备 中 运行 整个 测试 组 件 ，CI 服务 器 可 以 代劳 一 一 真是 太 好 
了 。 测 试 山 羊 的 另 一 个 代理 人 正在 网 络 空间 里 监视 我 们 呢 ! 


24.9 “CI 服务 器 能 完成 的 其 他 操作 


Jenkins 和 CI 服务 器 的 作用 只 介绍 了 皮毛 。 例 如 ， 还 可 以 让 CI 服务 器 在 监控 仓库 的 新 提交 
方面 变 得 更 智能 。 
或 者 做 些 更 有 趣 的 事 ， 除 了 运行 普通 的 功能 测试 之 外 ， 还 可 以 使 用 CI 服务 器 自动 运行 过 
渡 服 务 器 中 的 测试 。 如 有 果 所 有 功能 测试 都 能 通过 ， 你 可 以 添加 一 个 构建 步 又 ， 把 代码 部 署 
到 过 渡 服 务 器 中 ， 然 后 在 过 渡 服 务 器 中 再 运行 功能 测试 。 这 样 整个 过 程 又 多 了 一 步 可 以 自 
动 完 成 ， 而 且 可 以 保证 过 渡 服 务 器 始终 使 用 最 新 的 代码 。 

有 些 人 甚至 使 用 CI 服务 器 把 最 新 发 布 的 代码 部 署 到 生产 服务 器 中 。 





















































CI 和 Selenium 最 佳 实践 


。 尽早 为 自己 的 项 目 搭建 CI 服务 器 
一 旦 运行 功能 测试 所 花 的 时 间 超过 几 秒 钟 ， 你 就 会 发 现 自己 根本 不 想 再 运行 了 。 把 
这 个 任务 交 给 CI 服务 器 吧 ， 确 保 所 有 测试 都 能 在 某 处 运行 。 

。 测试 失败 时 截图 和 转 储 HTML 
如 果 你 能 看 到 测试 失败 时 网 页 是 什么 样 ， 调 试 就 容易 得 多 。 蕉 图 和 转 储 HIML 有 
助 于 调试 CI 服务 器 中 的 失败 ， 而 且 对 本 地 运行 的 测试 也 很 有 用 。 

。 时 刻 准 备 调整 超时 
CI 服务 器 的 运行 速度 可 能 没有 你 的 笔记 本 电脑 快 ， 尤 其 是 同时 运行 多 个 测试 、 负 载 
较 高 时 。 你 要 时 刻 准 备 调整 超时 ， 把 它 设 为 较 大 的 值 ， 尽 量 降低 随机 失败 的 概率 。 

。 想 办 法 把 CI 和 过 渡 服 务 器 连接 起 来 
使 用 LiveServerTestCase 的 测试 在 开发 环境 中 不 会 遇 到 什么 问题 ， 但 若 想 得 到 十 足 
的 保障 ， 就 要 在 真正 的 服务 器 中 运行 测试 。 想 办 法 让 CI 服务 器 把 代码 部 署 到 过 渡 
服务 器 中 ， 然 后 在 过 渡 服 务 器 中 运行 功能 测试 。 这 么 做 还 有 个 附带 好 处 : 测试 自动 
化 部 署 脚本 是 否 可 用 。 
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“现在 一 切 都 要 社会 化 ”的 调侃 是 不 是 有 点 过 时 了 ? 不 管 怎样 ， 现 在 一 切 都 是 经 过 AB ii 
试 和 大 数据 分 析 能 得 到 超 多 点 击 量 的 列表 ， 类 似 “ 创 意 导师 认为 将 大 覆 你 观念 的 十 件 事 ”。 
不 管 是 否 真能 激发 创意 ， 列 表 都 更 容易 传播 。 那 我 们 就 让 用 户 能 和 其 他 人 协作 完成 他 们 的 
列表 吧 。 


在 实现 这 个 功能 的 过 程 中 ， 我 们 将 使 用 页 面 对 象 模式 (Page Object pattern). 改进 功能 测试 。 


我 不 告诉 你 具体 做 法 ， 而 是 让 你 自己 编写 单元 测试 和 应 用 代码 。 别 担心 ， 我 不 会 让 你 完 
自己 动手 ， 会 告诉 你 大 概 步骤 和 一 些 提 示 。 


25.1 有 多 个 用 户 以 及 使 用 addCleanup 的 功能 测试 


开始 吧 。 这 个 功能 测试 需要 两 个 用 户 : 
































functional tests/test sharing.py (ch221001) 


from selenium import webdriver 
from .base import FunctionalTest 


def quit if possible(browser): 
try: browser.quit() 
except: pass 
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class SharingTest(FunctionalTest): 


def test can share a list with another user(self): 
# 伊 迪 丝 是 已 登录 用 户 
self.create pre authenticated session('edithQexample.com') 
edith browser - self.browser 
self.addCleanup(lambda: quit if possible(edith browser)) 














# 她 的 朋友 Oniciferous 也 在 使 用 这 个 清单 网 站 

oni browser = webdriver.Firefox() 

self.addCleanup(lambda: quit if possible(oni browser)) 
self.browser - oni browser 

self.create pre authenticated session('oniciferous(lexample.com') 














# 伊 迪 丝 访问 首页 ， 新 建 一 个 清单 
self.browser = edith browser 
self.browser.get(self.live server url) 
self.add list item('Get help') 

















# 她 看 到 “分 享 这 个 清单 ”选项 
share_box = self. browser Find. chenert Dyce eticetore 
'input[name="sharee"]' 





) 
self.assertEqual( 


share box.get attribute('placeholder'), 
' your - friendgexample.com' 


) 


这 一 节 有 个 功能 值得 注意 ，addcleanup 函数 ， 它 的 文档 可 以 在 线 查看 。 这 个 函数 可 以 代替 
tearDown 函数 ， 清 理 测 试 中 使 用 的 资源 。 如 果 资 源 在 测试 运行 的 过 程 中 才 用 到 ， 最 好 使 用 
addCleanup 国 数 ， 因 为 这 样 就 不 用 在 tearDown 国 数 中 花 时 间 区 分 哪些 资源 需要 清理 ， 哪 些 
不 需要 清理 。 


addCleanup 国 数 在 tearDown 图 数 之 后 运行 ， 所 以 在 quit if possible 国 数 中 才 要 使 用 
try/except 语句 ， 因 为 不 管 edith_browser 和 oni browser 中 哪 一 个 的 值 是 self.browser, 
测试 结束 时 tearDown 函数 都 会 关闭 这 个 浏览 器 。 


还 要 把 测试 方法 create_pre_authenticated_session 从 test_my_lists.py 移 到 base.py 中 。 
好 了 ， 看 一 下 测试 结果 如 何 : 









































$ python manage.py test functional tests.test sharing 
[5:1 
Traceback (most recent call last): 
File "/.../superlists/functional tests/test sharing.py", line 31, in 
test can share a list with another user 
Eed 
selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: input[name-"sharee"] 


太 好 了 ， 看 样子 可 以 创建 两 个 用 户 会 话 ， 而 且 得 到 了 一 个 意料 之 中 的 失败 ， 因 为 页 面 中 没 
有 填写 电子 邮件 地 址 的 输入 框 ， 无 法 分 享 给 别人 。 














现在 做 一 次 提交 ， 因 为 至 少 已 经 编写 了 一 个 占 位 功能 测试 ， 也 移动 了 create pre. 
authenticated session 国 数 ， 接 下 来 要 重 构 功能 测试 ， 


$ git add functional tests 
$ git commit -m "New FT for sharing, move session creation stuff to base" 


25.2 页面 模 式 


在 继续 之 前 ， 我 想 再 展示 一 种 减少 功能 测试 中 重复 代码 的 方式 ， 叫 作 “ 页 面 对 象 ”。 

我 们 为 功能 测试 构建 了 几 个 辅助 方法 ， 例 如 这 里 使 用 的 add_List_iten。 但 如 果 不 断 构建 
辅助 方法 ， 测 试 也 会 变 得 腾 肿 不 堪 。 我 曾 处 理 过 一 个 超过 1500 行 的 功能 测试 基 类 ， 想 改 
一 下 都 十 分 困难 。 
此 时 便 可 以 使 用 页 面 对 象 ， 尽 量 把 网 站 中 不 同类 型 页 面 的 所 有 信息 和 辅助 方法 放 在 一 处 。 
下 面 来 看 如 何在 网 站 中 使 用 页 面 对 象 。 首 先是 一 个 表示 清单 页 面 的 类 











































































































functional tests/list page.py 


from selenium.webdriver.common.keys import Keys 
from .base import wait 


class ListPage(object): 


def init (self, test): 
self.test = test Q 


def get table rows(self): © 
return self.test.browser.find elements by css selector('istid list table tr') 


(wait 

def wait for row in list table(self, item text, item number): 6 
expected row text = f'[item number): [item text}' 
rows - self.get table rows() 
self.test.assertIn(expected row text, [row.text for row in rows]) 


def get item input box(self): @ 
return self.test.browser.find element by id('id text') 


def add list item(self, item text): | 6 
new item no - len(self.get table rows()) * 1 
self.get item input box().send keys(item text) 
self.get item input box().send keys(Keys.ENTER) 
self.wait for row in list table(item text, new item no) 
return self OQ 


0 使 用 表示 当前 测试 的 对 象 初始 化 ， 这 样 就 能 声明 断言 、 通 过 self.test.browser 访问 
浏览 器 实例 ， 以 及 使 用 self.test.wait for 国 数 。 
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@ ”从 base.py 中 复制 一 些 现 有 的 辅助 方法 过 来 ， 不 过 稍微 做 了 一 点 调整 …… 
e ”例如 ， 使 用 了 这 个 新 方法 。 

@ ”返回 self 只 是 一 种 便利 措施 ， 以 便 串 接 方法 ( 稍 后 就 会 用 到 )。 

下 面 看 一 下 如 何在 测试 中 使 用 页 面 对 象 : 

















functional tests/test sharing.py (ch221004) 


from .list page import ListPage 


Eo] 











# 伊 迪 丝 访问 首页 ， 新 建 一 个 清单 
self.browser = edith browser 
list page - ListPage(self).add list item('Get help') 


继续 改写 测试 ， 只 要 想 访问 列表 页 面 中 的 元 素 ， 就 使 用 页 面 对 象 : 















































functional tests/test sharing.py (ch221008) 
# 她 看 到 “分 享 这 个 清单 ”选项 
share box = list page.get share box() 
self.assertEqual( 
share box.get attribute('placeholder'), 
' your -friendgexample.com' 








) 
# 她 分 享 自己 的 清单 之 后 ， 页 面 更 新 了 


# 提示 已 经 分 享 给 Oniciferous 
list page.share list with('oniciferous@example.com') 


我 们 要 在 ListPage 类 中 添加 以 下 三 个 方法 : 


functional tests/list page.py (ch221009) 


def get share box(self): 
return self.test.browser.find element by css selector( 
'Ànput[name-"sharee"]' 


) 


def get shared with list(self): 
return self.test.browser.find elements by css selector( 
'.list-sharee' 


) 


def share list with(self, email): 
self.get share box().send keys(email) 
self.get share box().send keys(Keys.ENTER) 
self.test.wait for(lambda: self.test.assertIn( 
email, 
[item.text for item in self.get shared with list()] 
)) 
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页 面 模 型 背后 的 思想 是 ， 把 网 站 中 某 个 页 面 的 所 有 信息 都 集中 放 在 一 个 地 方 ， 如 果 以 后 想 
要 修改 这 个 页 面 ， 比 如 简单 的 调整 HTML 布局 ， 功 能 测试 只 需 改动 一 个 地 方 ， 不 用 到 处 修 
改 多 个 功能 测试 。 

接 下 来 要 继续 重 构 其 他 功能 测试 。 在 这 里 我 就 不 细 说 了 ， 你 可 以 试 着 自己 完成 ， 感 受 一 下 
在 DRY 原则 和 测试 可 读 性 方面 要 做 哪些 折 中 处 理 。 


25.3 ”扩展 功能 测试 测试 第 二 个 用 户 和 “My Lists" 


页 面 
把 分 享 功能 的 用 户 故 事 写 得 更 详细 点 儿 。 伊 迪 丝 在 她 的 清单 页 面 看 到 这 个 清单 已 经 分 享 给 
Oniciferous， 然 后 Oniciferous 登录 ， 看 到 这 个 清单 出 现在 “My Lists” 页 面 中 ， 或 许 显示 
在 “分 享 给 我 的 清单 ”中 : 



























































functional tests/test sharing.py (ch221010) 


from .my lists page import MyListsPage 


[552] 


list page.share list with('oniciferous(eexample.com') 


# 现在 Oniciferous 在 他 的 浏览 器 中 访问 清单 页 面 
self.browser = oni browser 
MyListsPage(self).go to my lists page() 








# 他 看 到 了 伊 迪 丝 分 享 的 清单 
self.browser.find element by link text('Get help').click() 


为 此 ， 要 在 MyListPage 类 中 再 定义 一 个 方法 : 


functional tests/my lists page.py (ch221011) 


class MyListsPage(object): 


def init (self, test): 
self.test - test 


def go to my lists page(self): 
self.test.browser.get(self.test.live server url) 
self.test.browser.find element by link text('My lists').click() 
self.test.wait for(lambda: self.test.assertEqual( 
self.test.browser.find element by tag name('hi').text, 
'My Lists' 
) 


return self 
这 个 方法 最 好 放 到 test, my. lists.py 中 ， 或 许 还 可 以 再 定义 一 个 MyListsPage 类 。 
现在 ，Oniciferous 也 可 以 在 这 个 清单 中 添加 待 办 事项 : 
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functional tests/test sharing.py (ch221012) 


* 在 清单 页 面 ，Oniciferous 看 到 这 个 清单 属于 伊 迪 丝 
self.wait for(lambda: self.assertEqual( 
list page.get list owner(), 
'edithgexample.com' 








)) 


# 他 在 这 个 清单 中 添加 一 个 待 办 事项 
list page.add list item('Hi 伊 迪 丝 !) 








# 伊 迪 丝 刷新 页 面 后 ， 看 到 Oniciferous 添 加 的 内 容 
self.browser = edith browser 

self.browser.refresh() 

list page.wait for row in list table('Hi Edith!', 2) 


为 此 ， 要 在 ListPage 类 中 添加 一 个 方法 : 





functional tests/list page.py (ch221013) 


class ListPage(object): 


E] 


def get list owner(self): 
return self.test.browser.find element by id('id list owner').text 


早 就 该 运行 功能 测试 了 ， 看 看 这 些 测试 能 否 通过 : 
$ python manage.py test functional tests.test sharing 


share box = list page.get share box() 


ES] 


selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: input[name-"sharee"] 


这 个 失败 在 预料 之 中 ， 因 为 还 设 在 页 面 中 添加 输入 框 ， 填 写 电子 邮件 地 址 ， 分 享 给 别人 。 
做 次 提交 : 


$ git add functional tests 
$ git commit -m "Create Page objects for list pages, use in sharing FT" 


25.4 留 给 读者 的 练习 

做 完 25.4 节 的 练习 之 后 ， 我 才 算 完全 明和 白 自 己 在 做 什么 。 
Iain H. (读者 ) 
若 想 牢固 掌握 所 学 ， 没 什么 比 得 上 自己 动手 实践 。 所 以 ， 我 希望 你 能 试 着 去 做 下 述 练习 。 
大 致 步骤 如 下 。 
(1) 在 list.html 添加 一 个 新 区 域 ， 先 写 一 个 表单 ， 表 单 中 包含 一 个 输入 框 ， 用 来 输入 电子 

邮件 地 址 。 功 能 测试 应 该 会 前 进一步 。 

Q) 需要 一 个 视图 ， 处 理 表 单 。 先 在 模板 中 定义 URL， 例 如 lists/<list_id>/share。 
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(3) 然后 ， 编 写 第 一 个 单元 测试 ， 驱 动 我 们 定义 占 位 视图 。 我 们 希望 这 个 视图 处 理 POST 
请 求 ， 啊 应 是 重 定向 ， 指 向 清单 页 面 ， 所 以 这 个 测试 可 以 命名 为 ShareListTest.test_ 
post redirects to lists page, 

(编写 占 位 视图 ， 只 需 两 行 代码 ， 一 行 用 于 查找 清单 ， 一 行 用 于 重 定向 。 

(5 可 以 再 编写 一 个 单元 测试 ， 在 测试 中 创建 一 个 用 户 和 一 个 清单 ， 在 POST 请 求 中 发 送 

电子 邮件 地 址 ， 然 后 检查 List_.shared_with.all() (XWF “My Lists” 页 面 使 用 的 
那个 ORM 用 法 ) 中 是 否 包 含 这 个 用 户 。shared_with 属性 还 不 存在 ， 我 们 使 用 的 是 由 
外 而 内 的 方式 。 

(6) 所 以 在 这 个 测试 通过 之 前 ， 要 下 移 到 模型 层 。 下 一 个 测试 要 写 入 test models.py 中 。 
在 这 个 测试 中 ， 可 以 检查 清单 能 否 响应 shared with.add 方法 。 这 个 方法 的 参数 是 
用 户 的 电子 邮件 地 址 。 然 后 检查 清单 的 shared_with.all() 查询 集合 中 是 否 包 含 这 个 
用 户 。 

(T) 然后 需要 用 到 ManyToManyField。 或 许 你 会 看 到 一 条 错误 消息 ， 提 示 related name 有 
冲突 ， 查 阅 Django 的 文档 之 后 你 会 找到 解决 办 法 。 

O 需要 执行 一 次 数据 库 迁移 。 

(9) 然后 ， 模 型 测试 应 该 可 以 通过 。 回 过 头 来 修正 视图 测试 。 

(10) 可 能 会 发 现 重 定向 视图 的 测试 失败 ， 因 为 视图 发 送 的 POST 请 求 无 效 。 可 以 选择 忽略 
无 效 的 输入 ， 也 可 以 调整 测试 ， 发 送 有 效 的 POST 请 求 。 

OD 然后 回 到 模板 层 。“My Lists” 页 面 需要 一 个 <ul> 元 素 ， 使 用 for 循环 列 出 分 享 给 这 个 
用 户 的 清单 。 我 们 还 想 在 清单 页 面 显示 这 个 清单 分 享 给 谁 了 ， 并 注 明 这 个 清单 的 属 主 
是 谁 。 各 元 素 的 类 和 ID 参见 功能 测试 。 如 果 需 要 ， 还 可 以 为 这 几 个 需求 编写 简单 的 
单元 测试 。 

(12) 执行 runserver 命令 让 网 站 运行 起 来 ， 或 许 能 帮助 你 解决 问题 ， 以 及 调整 布局 和 外 观 。 
如 果 使 用 隐私 浏览 器 会 话 ， 可 以 同时 登录 多 个 用 户 。 

最 终 ， 可 能 会 得 到 类 似 图 25-1 所 示 的 页 面 。 























































































































Enter ato-do item 


1: new list 


List shared with: Share this list 


* harry. percivale»gmail.corn your(friends-email.com 
* harry@mockmyid.com 














图 25-31: 分 享 清 
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页 面 模式 以 及 真正 留 给 读者 的 练习 
测试 中 运用 DRY 原则 
功能 测试 多 起 来 后 ， 就 会 发 现 不 同 的 测试 使 用 了 UI 的 同一 部 分 。 尽 量 避 免 在 多 个 
功能 测试 中 使 用 重复 的 常量 ， 例 如 某 个 UI 元 素 HTML 代码 中 的 ID 和 类 。 


页 面 模式 
把 辅助 方法 移 到 FunctionalTest 基 类 中 会 把 这 个 类 变 得 脐 肿 不 堪 。 可 以 考虑 把 处 理 
网 站 特定 部 分 的 全 部 逻辑 保存 到 单独 的 页 面 对 象 中 。 


留 给 读者 的 练习 

希望 你 真 的 会 做 这 个 练习 | 试 着 遵守 由 外 而 内 的 开发 方式 ， 如 果 卡 住 了 ,偶尔 也 可 
以 手动 测试 。 当 然 ， 真正 留 给 读者 的 练习 是 ， 在 你 的 下 一 个 项 目 中 使 用 TDD。 项 
望 它 能 给 你 带 来 愉悦 的 体验 ! 











下 一 章 做 个 总 结 ， 探 讨 测试 的 “最 佳 实践 。 
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测试 运行 速度 的 快慢 和 炽热 的 各区 





“数据 库 是 炽热 的 岩浆 | ” 
Casey Kinsey 
在 第 23 章 之 前 ， 书 中 几乎 所 有 的 “单元 ”测试 或 许 都 应 该 叫 作 整合 测试 ， 因 为 这 些 测 试 
要 不 依赖 于 数据 库 ， 要 不 使 用 Django 测试 客户 端 ， 请 求 、 响 应 和 视图 国 数 之 间 的 中 间 层 
AUR ACE REUS T o 

有 种 说 法 认为 ， 真 正 的 单元 调试 一 定 要 隔离 ， 因 为 单元 测试 只 应 该 测试 软件 单独 的 一 
部 分 。 如 果 涉 及 数据 库 ， 那 就 不 是 单元 测试 。 数 据 库 是 炽热 的 岩浆 ! 

一 些 TDD 老手 说 ， 你 应 该 尽力 编写 完全 隔离 的 单元 测试 ， 而 不 要 编写 整合 测试 。 测 试 社 
区 一 直 都 有 这 样 的 争论 ， 有 时 还 很 白热化 。 

我 只 是 个 狂妄 的 年 轻 人 ， 对 这 场 争 论 的 细 市 并 不 太 了 解 。 但 在 这 一 章 里 ， 我 想 试 着 分 析 人 
门 为 什么 如 此 在 意 这 件 事 ， 然 后 给 出 一 些 建议 ， 告 诉 你 什么 时 候 勉 强 可 以 使 用 整合 测试 
(我 承认 很 多 时 候 我 都 是 这 样 做 的 )， 什 么 时 候 值得 争取 编写 更 纯粹 的 单元 测试 。 
























































术语 : 测试 的 不 同类 型 
。 隧 离 测试 (纯粹 的 单元 测试 ) 与 整合 测试 
单元 测试 的 主要 作用 应 该 是 验证 应 用 的 逻辑 是 否 正确 。 隔 离 测 试 只 能 测试 一 部 分 代 
码 ， 测 试 是 否 通过 与 其 他 任何 外 部 代码 都 没有 关系 。 我 所 说 的 纯粹 的 单元 测试 是 
指 ， 对 一 个 函数 的 测试 而 言 ， 只 有 这 个 函数 能 让 测试 失败 。 如 果 这 个 函数 依赖 于 其 
他 系统 且 破坏 这 个 系统 会 导致 测试 失败 ， 就 说 明 这 是 整合 测试 。 这 个 系统 可 以 是 外 
部 系统 ， 例 如 数据 库 ， 也 可 以 是 我 们 无 法 控制 的 另 一 个 函数 。 不 管 怎 样 ， 只 要 破坏 
系统 会 导致 测试 失败 ， 这 个 测试 就 没有 完全 隔离 ， 因 此 也 就 不 是 纯粹 的 单元 测试 。 
整合 测试 并 非 不 好 ， 只 不 过 可 能 意味 着 同时 测试 两 个 功能 。 
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。 集成 测试 
集成 测试 用 于 检查 被 你 控制 的 代码 是 否 能 和 你 无 法 控制 的 外 部 系统 完好 集成 。 集 成 
测试 往往 也 是 整合 测试 。 

。 系统 测试 
如 果 说 集成 测试 检查 的 是 与 外 部 系统 的 集成 情况 ， 那 么 系统 测试 就 是 检查 应 用 内 部 
多 个 系统 之 间 的 集成 情况 。 例 如 ， 检 查 数据 库 、 静 态 文件 和 服务 器 配置 在 一 起 是 否 
能 正常 运行 。 

。 功能 测试 和 验收 测试 
验收 测试 的 作用 是 从 用 户 的 角度 检查 系统 是 否 能 正常 运行 。( 用 户 能 接受 这 种 行为 
吗 ? ) 验收 测试 很 难 不 写成 全 栈 端 到 端 测试 。 在 前 文中 ， 使 用 功能 测试 代替 验收 测 
试 和 系统 测试 。 














请 原谅 我 的 自命 不 几 ， 下 面 我 要 使 用 一 些 哲 学 术语 ， 以 黑 格 尔 辩证 法 的 结构 讨论 这 些 问题 。 


。 正题 : 纯粹 的 单元 测试 运行 速度 快 。 

。 反 题 : 编写 纯粹 的 单元 测试 有 哪些 风险 ? 

。 合 题 : 讨论 一 些 最 佳 实践 ， 例 如 “端口 和 适配器 *”“ 函 数 式 核心 ,命令 式 外 党 ”以 及 我 
们 到 底 想 从 测试 中 得 到 什么 。 


26.1 正题 : 单元 测试 除了 运行 速度 超 快 之 外 还 有 
其 他 优势 


关于 单元 测试 你 经 常会 听 到 一 种 说 法 : 单元 测试 运行 速度 快 多 了 。 其 实 ， 我 不 觉得 这 是 单 
元 测试 的 主要 优势 ， 不 过 速度 的 确 值得 一 谈 。 


26.1.1 测试 运行 得 越 快 ， 开 发 速度 越 快 

在 其 他 条 件 相 同 的 情况 下 ， 单 元 测试 运行 的 速度 越 快 越 好 。 可 以 适当 推理 出 ， 所 有 测试 运 
行 的 速度 都 是 越 快 越 好 。 
本 书 前 文 已 经 概括 了 TDD 测试 /编写 代码 循环 。 你 已 经 开始 习惯 TDD 流程 ， 时 而 编写 最 
少量 的 代码 ， 时 而 运行 测试 。 以 后 ， 一 分 钟 内 你 要 多 次 运行 单元 测试 ， 一 天 之 内 要 多 次 运 
行 功 能 测试 。 

所 以 ， 简 单 而 言 ， 测 试 运 行 的 时 间 越 长 ， 等 待 测试 运行 完毕 的 时 间 就 越 长 ， 因 此 也 就 拖 慢 
了 开发 进度 。 而 且 问 题 还 不 止 于 此 。 


26.1.2 神 赐 的 心 流 状 态 


现在 从 社会 学 角度 分 析 。 我 们 程序 员 有 自己 的 文化 ， 有 自己 的 族群 信仰 。 这 个 族群 分 成 很 
多 群体 ， 例 如 崇拜 TDD 的 群体 (你 现在 已 经 成 为 其 中 一 员 )。 有 些 人 喜欢 vi， 还 有 些 人 离 
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经 叛 道 ， 喜 欢 emacs。 但 我 们 都 认同 一 件 事 : 神 赐 的 心 流 状态 一 一 这 是 一 种 精神 上 的 练习 ， 
我 们 自己 的 冥想 方式 。 我 们 的 精神 完全 专 广 ， 几 个 小 时 弹指 一 挥 间 就 过 去 ， 代 码 自 然而 然 
地 从 指 间 疲 出 ， 问 题 虽 然 乏味 环 手 ， 但 难 不 倒 我 们 。 


如 有 果 花 时 间 等 待 慢 吞 吞 的 测试 组 件 运行 完毕 ， 肯 定 无 法 进入 心 流 状态 。 只 要 超过 几 秘 钟 ， 
你 的 注意 力 就 会 分 散 ， 环 境 也 会 变化 ， 导 致 心 流 状态 消失 。 心 流 状态 就 像 梦 境 一 样 ， 只 
消失 ， 至 少 要 花 15 分 钟 才能 重 现 。 


26.1.3 经常 不 想 运行 速度 慢 的 测试 ， 导 致 代码 变 坏 

如 果 测试 组 件 运行 得 慢 ， 你 会 失去 耐心 ， 不 想 运行 测试 ， 这 会 导致 问题 横行 。 我 们 也 许 会 
闭 于 重 构 代码 ， 因 为 知道 重 构 后 要 花 很 多 时 间 等 待 所 有 测试 运行 完毕 。 这 两 种 情况 都 会 导 
致 代码 变 坏 。 


26.1.4 现在 还 行 ， 不 过 随 着 时 间 推 移 ， 整 合 测试 会 变 得 越 
来 越 慢 

你 可 能 觉得 没事 ， 测 试 组 件 中 有 很 多 整合 测试 ， 超 过 50 个 ， 但 运行 只 用 了 0.2 fh, 

可 是 要 知道 ， 这 个 应 用 很 简单 。 一 旦 应 用 变 得 复杂 ， 数 据 库 中 的 表 和 列 越 来 越 多 ， 整 合 测 

试 就 会 变 得 越 来 越 慢 。 在 两 个 测试 之 间 让 Django 重建 数据 库 所 用 的 时 间 会 越 来 越 长 。 

26.1.5 5| RUTSE— P AG 


Gary Bernhardt 的 测试 经 验 比 我 丰富 ， 他 在 演讲 “Fast Test, Slow Test” 中 生动 地 图 述 了 这 些 
观点 。 推 荐 你 看 一 下 演讲 视频 。 


26.1.6 单元 测试 能 驱使 我 们 实现 好 的 设计 

但 是 ， 比 上 述 几 点 更 重要 的 好 处 或 许 我 在 第 23 章 已 经 说 过 。 为 了 编写 隔离 性 好 的 单元 测 
试 ， 必 须知 道 依赖 下 一 层 中 的 什么 功能 ， 而 且 要 使 用 整合 测试 无 法 实现 的 解 看 式 架 构 ， 这 
有 助 于 设计 出 更 好 的 代码 。 


26.2 纯粹 的 单元 测试 有 什么 问题 

说 完 优点 我 们 要 来 个 大 转折 。 编 写 隔 离 的 单元 测试 也 有 其 危害 ， 尤 其 是 对 于 我 们 (包括 我 
和 你 ) 这 些 TDD 新 手 而 言 。 

26.2.4 隔离 的 测试 难 读 也 难 写 

回忆 一 下 我 第 一 个 隔离 的 单元 测试 ， 是 不 是 很 丑 ? 我 承认 ， 重 构 时 把 代码 移 到 表单 中 有 些 


改进 ， 但 想 一 下 如 果 没 这 么 做 呢 ? 代码 基 中 就 会 有 一 个 十 分 难 读 的 测试 。 就 算是 这 个 测试 
的 最 终 版 本 ， 也 仍 有 一 些 比 较 难 理解 的 部 分 。 
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26.2.2 ”隔离 测试 不 会 自动 测试 集成 情况 

稍 后 我 们 会 得 知 ， 隔 离 测试 只 测试 当前 关注 的 单元 ， 而 且 是 在 隔离 的 环境 中 测试 ， 这 种 测 
试 本 性 如 此 ， 不 测试 各 单元 之 间 的 集成 情况 。 

这 个 问题 众所周知 ， 也 有 很 多 缓解 的 方法 。 不 过 前 文 已 经 说 过 ， 这 些 缓解 措施 对 程序 员 来 
说 意味 着 要 付出 很 多 艰苦 努力 : 程序 员 要 记 住 各 单元 的 界面 ， 要 分 清 每 个 组 件 需要 履行 的 
合约 ， 除 了 要 为 单元 的 内 部 功能 编写 测试 之 外 ， 还 得 为 合约 编写 测试 。 


26.2.3 单元 测试 几乎 不 能 捕获 意料 之 外 的 问题 

单元 测试 能 帮助 你 捕获 差 一 错误 和 风 辑 混乱 导致 的 错误 ， 这 些 错误 在 编写 代码 时 经 常会 出 
现 ， 我 们 知道 这 一 点 ， 所 以 这 些 错误 在 意料 之 中 。 不 过 出 现 预料 之 外 的 问题 时 ， 单 元 测试 
不 会 提醒 你 。 如 果 忘 记 创 建 数 据 库 迁 移 ， 单 元 测试 不 会 提醒 你 ， 如 果 中 间 层 自作 聪明 转 义 
T HTML 实体 ， 从 而 影响 数据 的 渲染 方式 ， 显 示 成 “唐纳德 : 拉 姆 斯 非 尔 德 的 XX”， 单 元 
测试 也 不 会 提醒 你 。 


26.2.4 ”使 用 驭 件 的 测试 可 能 和 实现 方式 联系 紧密 

最 后 还 有 个 问题 ， 使 用 双 件 的 测试 可 能 和 实现 方式 之 间 过 度 炮 合 。 如 果 你 选择 使 用 List. 
objects.create() 创建 对 象 ， 但 是 驭 件 希 望 你 使 用 List() 和 .save()， 这 时 就 算 两 种 用 法 
的 实际 效果 一 样 ， 测 试 也 会 失败 。 如 果 不 小 心 ， 还 可 能 导致 测试 本 该 具有 的 一 个 好 处 缺 
失 ， 即 鼓励 重 构 。 如 果 想 修改 一 个 内 部 API， 你 会 发 现 自己 要 修改 很 多 使 用 驭 件 的 测试 和 
合约 测试 。 


注意 ， 处 理 你 无 法 控制 的 API 时， 这 可 能 不 单 是 一 个 问题 那么 简单 。 你 可 能 还 记得 我 们 如 
何 拐弯 抹 角 地 测试 表单 : 创建 两 个 Django 模型 级 件 ， 然 后 使 用 side effect 检查 环境 的 状 
态 。 如 果 编 写 的 代码 完全 在 自己 的 控制 之 中 ， 你 可 能 想 设 计 自 己 的 内 部 API， 这 样 写 出 的 
代码 更 简洁 ， 而 且 测 试 时 不 用 拐 这 么 多 弯 。 
26.2.5 ”这 些 问题 都 可 以 解决 


但 是 ， 倡 导 编写 隔离 测试 的 人 会 过 来 告诉 你 ， 这 些 问 题 都 可 以 缓解 ， 你 要 熟练 编写 隔离 测 
试 ， 还 得 进入 神 赐 的 心 流 状 态 。 


现在 我 们 论证 到 哪 一 步 了 ? 
26.3 合 题 : 我 们 到 底 想 从 测试 中 得 到 什么 
退 一 步 想 一 下 ， 我 们 想 从 测试 中 得 到 什么 好 处 ， 为 什么 一 开始 要 编写 测试 ? 


26.3.1 正确 性 


我 们 希望 应 用 没有 问题 ， 不 管 是 差 一 错误 之 类 的 低层 逻辑 错误 ， 还 是 高 层 问题 ， 例 如 软件 
最 终 应 该 提供 用 户 所 需 的 功能 。 我 们 想 知 道 是 否 引入 了 回归 ， 导 致 以 前 能 用 的 功能 失效 ， 
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而 且 想 在 用 户 察觉 之 前 发 现 。 我 们 还 期 望 测试 告诉 我 们 应 用 可 以 正常 运行 。 


26.3.2 简洁 可 维护 的 代码 

我 们 希望 代码 遵守 YAGNI 和 DRY 等 原则 ， 和 希望 代码 清晰 地 表明 意图 ， 使 用 合理 的 方式 分 
成 多 个 组 件 ， 而 且 各 组 件 作用 明确 、 容 易 理解 ， 希 望 从 测试 中 获取 自信 ， 可 以 放心 地 不 断 
重 构 应 用 ， 这 样 才 不 会 害怕 尝试 改进 设计 ， 还 希望 测试 能 主动 帮 有 我 们 找到 正确 的 设计 。 


26.3.3 高效 的 工作 流程 

最 后 ， 我 们 希望 测试 能 帮助 实现 一 种 快速 高 效 的 工作 流程 ， 希 望 测试 有 助 于 减轻 开发 压 
力 ， 而 且 避 免 让 我 们 犯 一 些 辕 春 的 错误 ; 希望 测试 能 让 我 们 始终 处 于 心 流 状 态 ， 因 为 心 流 
状态 不 仅 令 人 享受 ， 而 且 助 人 提高 工作 效率 ， 希望 测试 尽快 对 我 们 的 工作 做 出 反馈 ， 这 样 
就 能 尝试 新 想法 ， 并 尽早 改进 。 而 且 ， 改 进 代 码 时 ， 如 果 测 试 不 能 提供 帮助 ， 我 们 也 不 想 
让 它 成 为 障碍 。 


26.3.4 根据 所 需 的 优势 评估 测试 
我 觉得 应 该 编写 多 少 测试 ， 以 及 功能 测试 、 整 合 测 试 和 隔离 测试 的 量 怎么 分 配 ， 没 有 通用 
的 规则 ， 因 为 每 个 项 目的 情况 不 同 。 但 可 以 把 所 有 测试 都 纳入 考虑 范围 (如 表 26-1 PR), 
然后 考量 各 种 测试 ， 看 它们 能 否 提供 你 需要 的 优势 ， 由 此 做 出 判断 。 
表 26-1: 不 同类 型 的 测试 如 何 帮 助 我 们 达成 目标 
目标 一 些 考 量 事 项 
正确 性 。 站 在 用 户 的 角度 看 ， 功 能 测试 的 数量 是 否 足 够 保证 应 用 真 的 能 正常 运行 ? 
。 各 种 边界 情况 彻底 测试 了 吗 ? 感觉 这 是 低层 隔离 测试 的 任务 。 
。 有 没有 编写 测试 检查 所 有 组 件 之 间 是 否 能 正确 配合 ?要 不 要 编写 一 些 整合 测试 ， 
或 者 只 用 功能 测试 就 行 ? 
简洁 可 维护 的 代码 o 测试 有 没有 给 我 重 构 代码 的 自信 ， 而 且 可 以 无 所 基 慢 地 频繁 重 构 ? 
。 测试 有 没有 帮 我 得 到 一 个 好 的 设计 ?如 果 整 合 测试 较 多 、 隔 离 测 试 较 少 ， 我 要 投 
入 精力 为 应 用 的 哪 一 部 分 编写 更 多 隔离 测试 ， 才 能 得 到 关于 设计 更 全 面 的 反馈 ? 
高 效 的 工作 流程 。 反馈 循环 的 速度 令 我 满意 吗 ? 我 什么 时 候 能 得 到 问题 的 提醒 ? 有 没有 某 种 方法 可 
以 让 提醒 更 早出 现 ? 
。 如 果 高 层 功能 测试 很 多 ， 运 行 时 间 很 长 ， 要 花 整 晚 时 间 才 能 得 到 意外 回归 的 反 
馈 ， 有 没有 一 种 方法 可 以 让 我 编写 速度 更 快 的 测试 ， 整 合 测试 也 行 ， 让 我 早点 儿 
得 到 反馈 ? 
。 如 果 需 要 ， 我 能 否 运 行 整个 测试 组 件 的 一 个 子 集 ? 
。 我 是 否 花 了 太 多 时 间 等 待 测 试 运行 完毕 ， 导 致 高 效率 的 心 流 状态 时 间 缩 短 ? 


26.4 ”架构 方案 


还 有 一 些 架构 方案 可 以 帮助 测试 组 件 发 挥 最 大 的 作用 ， 而 且 特 别 有 助 于 避免 隔离 测试 的 
缺点 。 
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这 些 架 构 方案 大 都 要 求 找到 系统 的 边缘 ， 即 代码 和 外 部 系统 〈 例 如 数据 库 、 文 件 系统 、 万 
维 网 或 者 UI) 交互 的 地 方 ， 然 后 尝试 将 外 部 系统 和 应 用 的 核心 业务 逻辑 区 分 开 。 


26.4.1 ”端口 和 适配器 (或 六 边 形 、 简 洁 ) 架构 

集成 测试 在 系统 的 边界 ， 也 就 是 代码 和 外 部 系统 (例如 数据 库 、 文 件 系统 或 UI 组 件 ) 集 
成 的 地 方 ， 作 用 最 大 。 

所 以 ， 也 就 是 在 边界 ， 隔 离 测 试 和 驭 件 的 作用 最 小 ， 因 为 在 边界 如 果 测 试 和 某 种 实现 方式 
耦合 过 于 紧密 ， 最 有 可 能 干扰 你 ， 或 者 在 边界 需要 进一步 确认 各 组 件 之 间 是 否 正确 集成 。 
相反 ， 应 用 的 核心 代码 〈 只 关 广 业务 逻辑 和 业务 规则 的 代码 ， 完 全 在 我 们 控制 之 中 的 代 
码 ) 不 太 需 要 整合 测试 ， 因 为 我 们 能 控制 也 能 理解 这 些 代 码 。 

所 以 ， 实 现 需求 的 一 种 方法 是 尽量 减少 处 理 边界 的 代码 量 。 这 样 ， 就 可 以 使 用 隔离 测试 检 
查核 心 业务 逻辑 ， 使 用 整合 测试 检查 集成 点 。 

Steve Freeman 和 Nat Pryce 在 他 们 合 著 的 书 Growing Object-Oriented Software, Guided by Tests 
中 把 这 种 方案 称 为 “端口 和 适配器 ”( 如 图 26-1)。 













































































26-1: 端口 和 适配器 (Nat Pryce 绘制 ) 











EK, 第 23 章 已 经 朝 端口 和 适配器 架构 方案 努力 了 ， 当 时 我 们 发 现 编写 隔离 的 单元 测试 
要 把 ORM 代码 从 主 应 用 中 移 除 ， 定 义 为 模型 层 的 辅助 函数 。 


这 种 模式 有 时 也 叫 “ 简 洁 架 构 ” 或 “六 边 形 架 构 "。 详 情 参 见 本 章 末尾 的 扩展 阅读 部 分 。 
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26.4.2 ”函数 式 核心 ， 命 令 式 外 过 

Gary Bernhardt 更 进一步 ， 推 荐 使 用 他 称 为 “函数 式 核心 ， 命 令 式 外 这 ”的 架构 。 应 用 的 
“外 过 ”是 边界 交互 的 地 方 ， 遵 守 命 令 式 编程 范式 ， 可 以 使 用 整合 测试 、 验 收 测试 检查 ， 
如 果 精 简 到 一 定 程度 ， 其 至 完全 不 用 测试 。 而 应 用 的 核心 使 用 函数 式 编程 范式 编写 (完全 
没有 副作用 ) ， 因 此 可 以 使 用 完全 隔离 、 纯 粹 的 单元 测试 ， 根 本 无 须 使 用 驭 件 。 

这 个 方案 的 详细 说 明 ， 参 见 Gary 的 演讲 ， 主 题 为 Boundaries。 


26.5 小结 


尝试 概述 了 TDD 流程 涉及 的 深层 次 注意 事项 。 经 过 长 年 的 实践 经 验 积累 才能 领悟 这 些 
观点 ， 所 以 我 非常 没 资格 讨论 这 些 事情 。 我 衷心 鼓励 你 怀疑 我 所 说 的 一 切 ， 艾 试 不 同 的 方 
案 ， 听 听 其 他 人 是 怎么 说 的 ， 找 到 适合 自己 的 方法 。 


下 面 列 出 了 一 些 扩展 阅读 资料 。 


a BE 

扩展 阅读 

e “Fast Test, Slow Test” fe "Boundaries" 
Gary Bernhardt 分 别 于 2012 4E. (“Fast Test, Slow Test”) 和 2013 ^F. (“Boundaries”) 在 
Pycon 中 所 做 的 演讲 。 他 制作 的 视频 (Destroy All Software) 也 值得 一 看 。 

€ 荔 口 和 适配器 
Steve Freeman 和 Nat Pryce 在 他 们 合 著 的 书 中 提出 这 种 架构 。Steve Freeman 一 场 名 为 
“Test-Driven Development” 的 演讲 对 此 也 做 了 很 好 的 讨论 。 还 可 以 阅读 Uncle Bob 对 简 
洁 架 构 的 说 明 (“The Clean Architecture”)， 以 及 Alistair Cockburn 提出 六 边 形 架 构 的 文 


Æ (“Hexagonal Architecture”)。 


€ 炽热 的 宕 效 
Casey Kinsey 提醒 ， 尽 量 避 免 和 数据 库 交 互 (演讲 “Writing Fast and Efficient Unit Tests 
for Django"), 
。 翻转 金字 塔 
如 果 项 目 中 运行 速度 慢 的 高 层 测试 和 单元 测试 的 比值 太 大 ， 可 以 使 用 这 种 形象 的 比喻 努 
力 翻转 比值 。 
。 整合 测试 是 个 骗局 
J.B. Rainsberger 写 过 一 篇 著名 的 文章 (Integrated Tests Are A Scam"), ， 痛 斥 整合 测试 ， 
声称 它 会 毁 了 你 的 生活 。 还 可 以 阅读 几 篇 后 续 文 章 ， 尤 其 是 这 篇 防范 验收 测试 (我 叫 它 
功能 测试 ) 的 文章 (“Using Integration Tests Mindfully: A Case Study”)， 以 及 这 篇 分 析 
速度 慢 的 测试 是 如 何 扼杀 效率 的 文章 ("Part 2: Some Hidden Costs of Integration Tests”)。 
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e Test-Double 测试 维基 
Justin Searls 的 在 线 资源 (https://github.com/testdouble/contributing-tests/wiki/Test-Driven- 
Development) 对 相关 概念 做 出 了 准确 的 定义 ， 还 讨论 了 测试 的 优 缺 点 ， 而 且 总 结 了 各 
项 操作 的 正确 做 法 。 

。 务实 的 角度 
Martin Fowler (《 重 构 》 的 作者 ) 提出 一 种 合理 平衡 的 务实 方案 (http:/martinfowler. 
com/bliki/UnitTest.html) 。 





在 不 同 的 测试 类 型 之 间 正 确 权衡 
。 务实 为 本 
花费 大 量 时 间 纠 结 编写 何 种 测试 往往 得 不 偿 失 。 最 好 跟着 感觉 走 ， 先 编写 下 意识 
觉得 应 该 编写 的 测试 ， 然 后 再 根据 需要 修改 。 在 实践 中 学 习 。 
。 关注 想 从 测试 中 得 到 什么 
我 们 的 目标 是 正确 性 、 好 的 设计 和 快速 的 反馈 循环 。 不 同类 型 的 测试 以 不 同 的 方 
式 达 到 这 些 目 标 。 表 26-1 列 出 了 一 些 自问 的 好 问题 。 
。 架构 很 重要 
架构 在 某 种 程度 上 决定 了 所 需 的 测试 类 型 。 业 务 逻 辑 与 外 部 依赖 隔离 得 越 好 ， 代 
码 的 模块 化 程度 越 高 , 在 单元 测试 、 集成 测试 和 端 到 总 测试 之 间 便 能 达到 越 好 的 
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AU Eg 


回 过 头 再 看 测试 山羊 。 
你 可 能 会 说 :“ 唉 ， 哈 利 ， 大 概 17 章 之 前 ， 测 试 山 羊 就 疫 那 么 有 趣 了 。 请 容许 我 路 叫 几 
句 ， 我 要 用 测试 山羊 表达 一 些 重要 的 观点 。 


3 3254 

测试 很 难 

当 我 看 到 “遵从 测试 山羊 的 教诲 ”这 句 话 时 ， 第 一 印象 是 它 道 出 了 一 个 事实 : 测试 很 
难 一 一 不 是 说 测试 本 身 难 ， 而 是 难 在 坚持 ， 一 直 做 下 去 。 
走 捷径 少 写 几 个 测试 感觉 更 容易 。 而 且 心 理 上 更 难 接受 测试 ， 因 为 付出 的 努力 和 得 到 的 回 
报 太 不 成 正比 。 现 在 花 时间 编 写 的 测试 不 会 立即 显 出 功效 ， 要 等 到 很 久 以 后 才 有 作用 一 一 
或 许 几 个 月 之 后 避免 在 重 构 过 程 中 引入 问题 ， 或 者 升级 依赖 时 捕获 回归 。 或 许 测试 会 以 一 
种 很 难 衡量 的 方式 回报 你 ， 促 使 你 写 出 设计 更 好 的 代码 ， 但 你 却 认 为 就 算 没 有 测试 也 能 写 
出 如 此 优雅 的 代码 。 

为 本 书 编 写 测 试 框架 时 ，(http://github.com/hjwp/Book-TDD-Dev-Python/tree/master/tests) 
我 自己 也 开始 犯 这 种 错误 了 。 书 中 的 代码 很 复杂 ， 所 以 本 身 也 有 测试 ， 但 我 偷懒 了 ， 测 试 
覆盖 度 并 不 理想 ,现在 我 后 悔 了 ， 因 为 测试 写 得 策 拙 又 丑陋 (好 了 ， 我 已 经 开源 这 个 测试 
HER, JER, MERE), 


让 CI 构建 始终 能 通过 
需要 真正 付出 心力 的 另 一 个 领域 是 持续 集成 。 读 过 第 24 章 我 们 知道 ，CI 构建 有 时 会 出 现 
意料 之 外 的 奇怪 问题 。 出 现 这 种 问题 时 ， 如 果 觉 得 在 自己 的 设备 中 正常 就 行 ， 很 容易 放任 
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不 管 。 但 是 ， 如 果 不 小 心 ， 你 会 开始 容忍 CI 中 有 失败 的 测试 组 件 ， 入 而 久之，CI 构建 便 失 
去 了 意义 。 若 想 再 次 让 CI 构建 运行 起 来 ， 工 作 量 更 大 。 千 万 别 落 入 这 个 圈套 。 只 要 坚持 ， 
终究 会 找到 测试 失败 的 原因 ， 而 且 能 找到 解决 的 方法 ， 再 次 让 构建 通过 ， 发 挥 决断 作用 。 


像 重视 代码 一 样 重视 测试 
别 再 把 测试 看 成 真正 的 代码 的 陪衬 ， 把 它 当 作 你 在 开发 的 产品 的 一 部 分 ， 精 心 雕琢 ， 注 重 
美观 ， 就 算 发 布 出 去 也 不 会 羞 于 面 对 众 人 检视 。 这 么 想 有 助 于 你 接受 测试 。 


做 测试 的 原因 有 很 多 : 可 能 是 测试 山羊 告诉 你 要 做 ， 可 能 是 你 知道 就 算 不 能 立即 得 到 回 
报 ,但 终究 会 得 到 ， 可 能 是 出 于 责任 感 、 职 业 素养 、 强 迫 症 或 者 想 挑战 自己 ， 还 可 能 是 因 
为 测试 值得 实践 。 但 终极 原因 是 ， 测 试 让 软件 开发 变 得 更 有 乐趣 。 


别 筷 了 给 吧台 服务 员 小 费 


没有 O'Reilly Media 出 版 社 的 支持 ， 我 不 可 能 写成 这 本 书 。 如 果 你 看 的 是 在 线 免费 版 ， 希 
望 你 能 考虑 买 一 本 。 如 果 你 自己 不 需要 ， 或 许可 以 作为 礼物 送 给 朋友 。 


ri 
别 见 外 
希望 你 喜欢 这 本 书 。 请 一 定 要 和 我 联系 ， 告 诉 我 你 的 想法 | 


e Ghjwp (Ttwitter) 
e obeythetestinggoat ? gmail.com 
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附录 人 A 
PythonAnywhere 





本 书 假设 你 在 自己 的 电脑 上 运行 Python 和 编程 。 当 然 ， 这 不 是 如 今 做 Python 编程 的 唯一 
方式 ， 你 也 可 以 使 用 在 线 平 台 ， 例 如 PythonAnywhere ( 磁 巧 ， 我 就 在 这 工作 )。 


在 阅读 本 书 的 过 程 中 ， 你 可 以 使 用 PythonAnywhere， 但 是 要 做 些 调 整 和 修改 : 测试 时 要 设 
置 一 个 Web 应 用 而 不 是 用 测试 服务 器 ， 要 使 用 Xvfb 运行 功能 测试 ， 而 且 读 到 部 署 那 儿童 
时 ， 要 升级 到 付费 帐户。 虽然 可 以 这 么 做 ， 但 还 是 使 用 自己 的 电脑 更 方便 。 


倘若 你 确实 想 试 一 下 ， 可 以 参照 下 文 所 述 去 做 。 
如 果 你 还 设 有 PythonAnywhere 的 账户 ， 先 要 注册 一 个 ， 免 费 的 就 行 。 
然后 ， 在 控制 台 页 面 启动 一 个 Bash Console。 大 多 数 工 作 都 将 在 这 个 控制 台中 完成 。 


A.1 使 用 Xvfb 在 Firefox 中 运行 Selenium 会 话 
首先 要 知道 ，PythonAnywhere 是 只 有 终端 的 环境 ， 所 以 没有 显示 器 就 无 法 打开 Firefox, 
但 我 们 可 以 使 用 虚拟 显示 器 。 

读 第 1 章 编 写 第 一 个 测试 时 ， 你 会 发 现 无 法 正常 运行 。 第 一 个 测试 如 下 所 示 ， 可 以 在 
PythonAnywhere 提供 的 编辑 器 中 输入 : 





























from selenium import webdriver 
browser = webdriver.Firefox() 
browser.get('http://localhost:8000') 
assert 'Django' in browser.title 


但 〈 在 Bash 终端 ) 运行 时 会 看 到 如 下 错误 : 
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(superlists)$ python functional tests.py 

Traceback (most recent call last): 

File "tests.py", line 3, in «module» 

browser - webdriver.Firefox() 

[5:1 

selenium.common.exceptions.WebDriverException: Message: 'geckodriver' executable 
needs to be in PATH. 


这 是 因为 PythonAnywhere 所 用 的 Firefox 是 旧版 本 ， 不 需要 Geckodriver。 但 是 ， 我 们 要 把 
Selenium 3 换 成 Selenium 2 


(superlists) $ pip install "selenium<3" 
Collecting selenium«3 
Installing collected packages: selenium 
Found existing installation: selenium 3.4.3 
Uninstalling selenium-3.4.3: 
Successfully uninstalled selenium-3.4.3 
Successfully installed selenium-2.53.6 


现在 又 会 遇 到 一 个 问题 : 


(superlists)$ python functional tests.py 

Traceback (most recent call last): 

File "tests.py", line 3, in «module» 

browser - webdriver.Firefox() 

[5:25] 

selenium.common.exceptions.WebDriverException: Message: The browser appears to 
have exited before we could connect. If you specified a log file in the 
FirefoxBinary constructor, check it for details. 


Firefox 无 法 启动， 因为 没有 运行 所 需 的 显示 器 ， 毕 竟 PythonAnywhere 是 服务 器 环境 。 解 
决 方法 是 使 用 Xvfb (X Virtual Framebuffer 的 简称 )。 在 没有 真正 的 显示 器 的 服务 器 中 ， 
Xvfb 会 启动 一 个 “虚拟 ”显示 器 ， 供 Firefox 使 用 。 


xvfb-run 命令 的 作用 是 ， 在 Xvfb 中 执行 下 一 个 命令 。 使 用 这 个 命令 就 会 看 到 预期 失败 : 


(superlists)$ xvfb-run -a python functional tests.py 
Traceback (most recent call last): 

File "tests.py", line 11, in «module» 

assert 'Django' in browser.title 

AssertionError 


记 住 ， 只 要 想 运行 功能 测试 ， 就 要 使 用 xvfb-run -a 命令 。 








A.2 ”以 PythonAnywhere Web 应 用 的 方式 安装 Django 


随后 要 使 用 django-admin.py startproject 命令 创建 Django 项 目 。 但 是 ， 不 要 使 用 manage.py 
runserver 启动 本 地 开发 服务 器 ， 我 们 将 把 网 站 设置 为 真正 的 PythonAnywhere Web 应 用 。 


打开 “Web” 标 签 页 ， 点 击 按钮 添加 一 个 新 Web JH. Wf% "Manual configuration” (F 
动 配置 )， 然 后 再 选 “Python 3.4", 
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在 下 一 个 界面 中 输入 虚拟 环境 的 名 称 (“superlists”), 提交 后 , 会 自动 补 全 为 /home/yourusername/ 
.Virtualenvs/superlists。 

最 后 ， 找 到 编辑 wsgi 文 件 的 链接 ， 找 出 针对 Django 的 那 一 部 分 ， 去 掉 注 释 。 点 击 
"Save", HAt "Reload", Ar Web 应 用 。 

从 现在 开始 ， 不 要 在 控制 台中 运行 localhost:8000 上 的 测试 服务 器 ， 你 可 以 使 用 PythonAnywhere 
为 Web 应 用 分 配 的 真实 URL 了 : 


browser .get('http://my-username.pythonanywhere.com') 
































每 次 修改 代码 后 都 要 点 击 “Reload Web App”( 重 新 加 载 Web 应 用 ) 按钮 ， 
更 新 网 站 。 





效果 更 好 ! ， 在 第 7 章 换 用 LiveServerTestCase 和 self. live server url 之 前 ,在 PythonAnywhere 
中 必须 这 样 指 向 功能 测试 ， 而 且 每 次 运行 功能 测试 之 前 都 要 点 击 “Reload”。 


A.3 清理 /tmp 目 录 
Selenium 和 Xvfb 会 在 /tmp 目录 中 留 下 很 多 垃圾 ， 如 果 关 闭 的 方式 不 优雅 ， 情 况 会 更 糟 
(所 以 前 文才 要 使 用 try/finally 语句 )。 
遗留 的 东西 太 多 ， 可 能 会 用 完 存储 配额 。 所 以 要 经 常 清理 /tmp 目录 : 
$ rm -rf /tmp/* 


A.4 截图 

在 第 5 章 中 ， 我 建议 使 用 tine.sleep 在 功能 测试 运行 的 过 程 中 暂停 一 会 儿 ， 这 样 才能 在 屏 
幕 上 看 到 Selenium 浏览 器 。 在 PythonAnywhere 做 不 到 这 一 点 ， 因 为 浏览 器 运行 在 虚拟 显 
示 器 中 。 不 过 你 可 以 检查 线 上 网 站 ,或 者 别管 应 该 看 到 什么 ， 相 信 我 说 的 就 行 了 。 

对 运行 在 虚拟 显示 器 中 的 测试 做 视觉 检查 ， 最 好 的 方法 是 使 用 截图 。 如 果 你 想 知道 怎么 
做 ， 看 一 下 第 24 章 ， 那 里 有 一 些 示例 代码 。 


A.5 关于 部 署 


读 到 第 9 章 时 ， 你 可 以 选择 继续 使 用 PythonAnywhere， 也 可 以 选择 学 习 如 何 配置 真实 的 服 
务 器 。 我 建议 选择 后 者 ， 因 为 这 样 能 学 到 更 多 。 


















































注 1: 也 可 以 在 终端 里 运行 开发 服务 器 , 但 有 个 问题 , PythonAnywhere 的 终端 不 一 定 运 行 在 同一 台 服 务 器 中 ， 
所 以 无 法 保证 运行 测试 的 终端 和 运行 服务 器 的 终端 是 同一 个 。 而 且 ， 如 果 在 终端 里 运行 服务 器 ， 没 有 
简单 的 方法 视觉 检查 网 站 的 外 观 。 
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如 果 想 一 直 使 用 PythonAnywhere， 可 以 再 注册 一 个 PythonAnywhere 账户 ， 用 作 过 渡 网 站 
( 作 汐 嫌疑 很 大 )。 或 者 ， 为 现 有 账户 再 添加 一 个 域名 。 但 部 署 那 一 章 的 内 容 就 用 不 到 了 
(在 PythonAnywhere 上 无 须 Nginx、Gunicorn 或 域 套 接 字 ) 。 

遇 到 下 列 情 形 之 一 时 ， 你 需要 一 个 付费 账户 。 

。 如 果 过 渡 网 站 不 使 用 PythonAnywhere 提供 的 域名 。 

。 如 果 不 想 在 PythonAnywhere 提供 的 域名 上 运行 功能 测试 (因为 别 的 域名 不 在 白 名 单 上 )。 
。 读 到 第 11 章 ， 如 果 想 使 用 PythonAnywhere 账户 运行 Fabric (因为 需要 SSH), 

如 果 你 想 “ 作 弊 "， 可 以 在 现 有 的 Web 应 用 中 以 “过 渡 ” 模 式 运 行 功 能 测试 ， 并 跳 过 涉及 
Fabric 的 部 分 这 算是 一 种 妥协 吧 。 其 实 ， 你 可 以 先 升级 账户 ， 然 后 立即 取消 ， 在 30 天 
保障 期 内 申请 退 款 。 








如 果 阅 读本 书 时 你 从 头 至 尾 都 使 用 PythonAnywhere， 我 很 想 听 听 你 是 怎么 做 
到 的 。 请 给 我 发 电子 邮件 ， 地 址 是 obeythetestinggoat@ gmail.com, 
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附录 B 


基于 类 的 Djang0 视 图 





本 附录 接续 第 15 章 。 第 15 章 实现 了 Django 表单 的 验证 功能 ， 还 重 构 了 视图 。 结 束 时 ， 视 
图 仍然 使 用 函数 实现 。 


不 过 ，Django 领域 现在 流行 使 用 基于 类 的 视图 (Class-Based View，CBV)。 在 这 个 附录 
中 ， 我 们 要 重 构 应 用 ， 把 视图 函数 改写 成 基于 类 的 视图 。 更 确切 地 说 ， 我 们 要 尝试 使 用 基 
于 类 的 通用 视图 (Class-Based Generic View, CBGV), 


B.1 基于 类 的 通用 视图 

基于 类 的 视图 和 基于 类 的 通用 视图 有 个 区 别 。 基 于 类 的 视图 (class-based view, CBV) 只 
是 定义 视图 函数 的 另 一 种 方式 ， 对 视图 要 做 的 事情 没有 太 多 假设 ， 和 视图 函数 相 比 主要 的 
优势 是 可 以 创建 子 类 。 不 过 也 要 付出 一 定 代价 ， 基 于 类 的 视图 比 传统 的 基于 函数 的 视图 可 
读 性 差 (这 一 点 有 争论 )。 普 通 的 CBV 的 作用 是 让 多 个 视图 重用 相同 的 逻辑 ， 因 为 我 们 想 
遵守 DRY 原则 。 如 果 使 用 基于 函数 的 视图 ， 重 用 逻辑 要 使 用 辅助 函数 或 修饰 器 。 理 论 上 ， 
使 用 类 实现 更 优雅 。 


基于 类 的 通用 视图 也 是 一 种 基于 类 的 视图 ， 但 它 尝 试 为 常见 操作 提供 现成 的 解决 方案 ， 例 
如 从 数据 库 中 获取 对 象 后 传 和 人 模板， 获取 一 组 对 象 ， 使 用 ModeLForm 保存 POST 请 求 中 用 户 
输入 的 数据 ， 等 等 。 看 起 来 现在 需要 的 就 是 这 种 视图 ， 不 过 稍 后 就 会 发 现 魔鬼 藏 在 细节 中 。 
这 里 我 想 说 ， 我 并 不 常用 任何 一 种 基于 类 的 视图 。 我 完全 能 看 到 这 种 视图 的 合理 之 处 ， 而 且 
在 Django 应 用 中 有 很 多 地 方 都 非常 适合 使 用 CBGV。 但 是 ， 只 要 需求 稍微 高 一 点 儿 ， 例 如 
想 使 用 多 个 模型 ， 就 会 发 现 基于 类 的 视图 比 传统 的 视图 函数 难 读 得 多 (这 一 点 也 有 和 争论 )。 
不 过 ， 因 为 必须 使 用 基于 类 的 视图 提供 的 几 个 定制 选项 ， 通 过 这 种 实现 方式 能 学 到 很 多 这 
种 视图 的 工作 方式 ， 以 及 如 何 为 这 种 视图 编写 单元 测试 。 






















































































































































































385 








/说 
T 
二 
yn 
F 
NY 
em 








R05 58 A JE T ECC ARES Aja 5 AIE 7 COE EC UL RE LE H UI LAE T 2S B) LE 
么 做 。 


B.2 使 用 FormView 实 现 首页 
网 站 的 首页 只 是 在 模板 中 显示 一 个 表单 ， 








lists/views.py 


def home page(request): 
return render(request, 'home.html', ['form': ItemForm()]) 


看 过 可 选 视图 (https://docs.djangoproject.com/en/1.11/ref/class-based-views/) 之 后 ， 我 们 发 
现 Django 提供 了 一 个 通用 视图 ， 叫 Formview。 看 一 下 怎么 用 : 

















lists/views.py (ch311001) 
from django.views.generic import FormView 


P 


class HomePageView(FormView): 
template name - 'home.html' 
form class - ItemForm 


指定 想 使 用 哪个 模板 和 表单 。 然 后 ， 只 需 更 新 urls.py， 把 含有 lists.views.home page 那 
行 代码 改 成 ; 








n 


superlists/urls.py (ch311002) 
[...] 


urlpatterns - [ 
url(r'^$', list views.HomePageView.as view(), name-'home'), 
url(r'^lists/', include(list urls)), 


] 
运行 所 有 测试 确认 ， 这 很 简单 : 


$ python manage.py test lists 


[...] 





Ran 34 tests in 0.119s 
OK 


$ python manage.py test functional tests 


Ls] 
Ran 5 tests in 15.160s 
OK 


目前 为 止 一 切 顺利 。 把 一 行 代码 的 视图 函数 换 成 有 两 行 代 码 的 类 ， 而 且 可 读 性 依然 不 错 。 
现在 是 提交 的 好 时 机 。 











386 | 附录 B 


B.3 使 用 form_valid 定 制 CreateView 


下 面 改写 新 建 清单 的 视图 ， 也 就 是 new list 函数 。 现 在 这 个 视图 如 下 所 示 : 



































lists/views.py 


def new_list(request): 

form = ItemForm(data=request.POST) 

if form.is valid(): 
list = List.objects.create() 
form.save(for list-list ) 
return redirect(list ) 

else: 
return render(request, 'home.html', ("form": form)) 


浏览 可 用 的 CBGV 列表 之 后 ， 发 现 需要 的 或 许 是 CreateView， 而 且 知 道 要 使 用 ItemForm 
类 ,下 面 看 一 下 具体 该 怎么 做 ， 以 及 测试 能 否 提 供 帮 助 : 





























lists/views.py (ch311003) 


from django.views.generic import FormView, CreateView 


kse] 


class NewListView(CreateView): 
form_class = ItemForm 


def new_list(request): 


[...] 


我 要 在 views.py 中 保留 原来 的 视图 函数 ， 这 样 才能 从 中 复制 代码 ， 等 一 切 都 能 正常 运行 之 
后 再 删除 。 这 么 做 没什么 危害 ， 只 要 修改 URL 映射 就 行 。 这 一 次 要 这 么 改 : 




















lists/urls.py (ch311004) 
[i 


urlpatterns = [ 
url(r'^new$', views.NewListView.as view(), name-'new list'), 
url(r'^(\d+)/$', views.view list, name-'view list'), 


] 

然后 运行 测试 。 有 6 个 错误 : 
$ 
[. 


python manage.py test lists 


ERROR: test can save a POST request (lists.tests.test views.NewListTest) 
TypeError: save() missing 1 required positional argument: 'for list' 


ERROR: test for invalid input passes form to template 

(lists.tests.test views.NewListTest) 
django.core.exceptions.ImproperlyConfigured: TemplateResponseMixin requires 
either a definition of 'template name' or an implementation of 

'get template names()' 
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ERROR: test for invalid input renders home template 

(lists.tests.test views.NewListTest) 
django.core.exceptions.ImproperlyConfigured: TemplateResponseMixin requires 
either a definition of 'template name' or an implementation of 

'get template names()' 


ERROR: test invalid list items arent saved (lists.tests.test views.NewListTest) 
django.core.exceptions.ImproperlyConfigured: TemplateResponseMixin requires 
either a definition of 'template name' or an implementation of 

'get template names()' 


ERROR: test redirects after POST (lists.tests.test views.NewlListTest) 
TypeError: save() missing 1 required positional argument: 'for list' 


ERROR: test validation errors are shown on home page 

(lists.tests.test views.NewListTest) 
django.core.exceptions.ImproperlyConfigured: TemplateResponseMixin requires 
either a definition of 'template name' or an implementation of 

'get template names()' 


FAILED (errors-6) 





先 解决 前 3 个 一 一 设 定 模板 应 该 就 可 以 了 吧 ? 


lists/views.py (ch311005) 


class NewListView(CreateView): 
form class - ItemForm 
template name - 'home.html' 








现在 只 剩 两 个 错误 了 ， 可 以 看 出 ， 这 两 个 错误 都 发 生 在 通用 视图 的 form valid 方法 中 。 这 
个 方法 可 以 重新 定义 来 定制 CBGV 的 行为 。 从 这 个 方法 的 名 字 可 以 看 出 ， 视 图 认为 表单 中 
的 数据 有 效 之 后 才 会 运行 这 个 方法 。 可 以 从 以 前 的 视图 函数 中 把 if form.is_valid(): 之 
后 的 代码 复制 过 来 : 


Xt 














lists/views.py (ch311006) 


class NewListView(CreateView): 
template name - 'home.html' 
form class - ItemForm 


def form valid(self, form): 
list = List.objects.create() 
form.save(for list-list ) 
return redirect(list ) 


单 测试 就 能 全 部 通过 了 ， 





$ python manage.py test lists 

Ran 34 tests in 0.119s 

OK 

$ python manage.py test functional tests 
Ran 5 tests in 15.157s 

OK 
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而 且 ， 为 了 遵守 DRY 原则 ， 可 以 使 用 CBV 的 主要 优势 之 一 一 一 继承 ， 节 省 两 行 代码 : 


lists/views.py (ch311007) 


class NewListView(CreateView, HomePageView): 


def form valid(self, form): 
list = List.objects.create() 
form.save(for list-list ) 
return redirect(list ) 


测试 应 该 仍 能 全 部 通过 : 
OK 




















其 实在 面向 对 象 编程 中 这 么 做 并 不 好 。 继 承 意味 着 “是 一 个 什么 ”这 种 关 
系 ， 但 是 说 新 建 清单 视图 “是 一 个 ”首页 视图 或 许 没 有 什么 意义 。 所 以 ,或 
许 最 好 别 这 么 做 。 


















































不 管 做 没 做 最 后 一 步 ， 你 觉得 和 以 前 的 版 本 相 比 怎么 样 ? 我 觉得 还 不 错 。 不 用 写 样板 代码 
了 了， 而且 视图 代码 还 相当 易 读 。 目 前 ，CBGYV 得 了 一 分 ， 和 基于 函数 的 视图 平局 。 


B.4 ”一 个 更 复杂 的 视图 ， 既 能 查看 清单 ， 也 能 户 
青 单 中 添加 竺 办 事项 


我 做 了 好 多 尝试 才 写 出 这 个 视图 。 不 得 不 说 ， 虽 然 测 试 能 告诉 我 做 得 对 不 对 ， 但 是 在 寻 
找 实现 步骤 的 过 程 中 并 不 能 给 出 实质 帮助 ， 大 多 数 情况 下 我 都 在 反复 实验 ， 尝 试 使 用 
get context data 和 get form kwargs 等 国 数 。 

不 过 ， 在 实现 的 过 程 中 我 意识 到 一 件 事 : 编写 多 个 只 测试 一 件 事 的 测试 很 重要 。 所 以 又 回 
头 重 写 了 第 10~12 章 的 部 分 内 容 。 


B.4.1 测试 有 指引 作用 ， 但 时 间 不 长 
下 面 是 一 种 实现 方式 。 首 先 ， 我 觉得 需要 使 用 petattview， 显 示 对 象 的 详情 ， 


lists/views.py (ch311009) 


from django.views.generic import FormView, CreateView, DetailView 


[...] 
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class ViewAndAddToList(DetailView): 
model = List 


然后 在 urls.py 中 设置 : 


lists/urls.py (ch311010) 


url(r'^(\d+)/$', views.ViewAndAddToList.as view(), name='view_list'), 
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测试 的 结果 为 ， 

[55x] 
AttributeError: Generic detail view ViewAndAddToList must be called with either 
an object pk or a slug. 


FAILED (failures-5, errors-6) 
失败 消息 的 意思 并 不 明确 ， 在 谷歌 中 搜索 一 番 之 后 我 才 知道 要 使 用 正则 表达 式 具 名 捕获 组 : 
lists/urls.py (ch3 11011) 








QQ -3,6 +3,6 QQ from lists import views 


urlpatterns = [ 
url(r'^new$', views.NewListView.as view(), name-'new list'), 
- Url(r'^(\d+)/$', views.view list, name-'view list'), 
* url(r'^(?P<pk>\d+)/$', views.ViewAndAddTolist.as view(), name-'view list') 


] 
接 下 来 出 现 的 错误 中 有 一 个 相当 有 帮助 
12] 


django.template.exceptions.TemplateDoesNotExist: lists/list detail.html 
FAILED (failures-5, errors-6) 
这 个 很 容易 解决 : 
lists/views.py (ch311012) 


class ViewAndAddToList(DetailView): 
model - List 
template name - 'list.html' 


这 次 改动 后 ， 只 剩 5 个 失败 和 2 个 错误 了 : 
[D] 
ERROR: test displays item form (lists.tests.test views.ListViewTest) 


KeyError: 'form' 


FAILED (failures-5, errors-2) 


B.4.2 现在 不 得 不 反复 实验 
我 发 现 这 个 视图 不 仅 要 显示 对 象 的 详情 ， 还 要 能 新 建 对 象 。 所 以 这 个 视图 要 继承 Detailview 
和 CreatevView， 可 能 还 要 添加 form-class 属性 : 








lists/views.py (ch311013) 


class ViewAndAddToList(DetailView, CreateView): 
model - List 
template name - 'list.html' 
form class = ExistinglistItemForm 





390 | 附录 B 


但 是 这 么 改 ， 得 到 了 很 多 错误 : 
[dl 


TypeError: _ init () missing 1 required positional argument: 'for list' 
而 且 那 个 KeyError: 'form' 错误 还 在 。 


现在 ,错误 消息 没什么 用 了 ， E e DU ATUM 我 不 得 不 反复 实验 。 不 过 ， 
测试 仍 能 告诉 我 做 得 对 还 是 把 情况 变 得 更 精 了 。 


首先 尝试 使 用 get_form_kwargs， 但 没什么 用 ， 不 过 我 发 现 可 以 使 用 get. form; 











lists/views.py (ch311014) 
def get form(self): 
self.object - self.get object() 
return self.form class(for list-self.object, data-self.request.POST) 
但 必须 给 self .object 赋值 才能 使 用 get_form， 对 此 我 一 直 心 里 不 安 。 不 过 现在 只 剩 3 
错误 了 ， 显 然 是 因为 表单 还 没 传人 模板 。 
django.core.exceptions.ImproperlyConfigured: No URL to redirect to. Either 
provide a url or define a get absolute url method on the Model. 


B.4.3 测试 再 次 发 挥 作 用 


对 最 后 的 这 个 失败 ， 测 试 又 变 有 用 了 。 解 决 的 方法 很 简单 ， 在 Item 类 中 定义 get. absolute url 
方法 ， 让 待 办 事项 指向 所 属 的 清单 页 面 即 可 : 












































lists/models.py (ch311015) 
class Item(models.Model): 


[ot] 


def get absolute url(self): 
return reverse('view list', args-[self.list.id]) 


B.4.4 这 是 最 终结 果 吗 
最 终 写 出 的 视图 类 如 下 所 示 : 





lists/views.py 


class ViewAndAddTolist(DetailView, CreateView): 
model - List 
template name - 'list.html' 
form class = ExistinglistlItemForm 


def get form(self): 
self.object = self.get object() 
return self.form class(for list-self.object, data-self.request.POST) 
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B.5 新 旧版 对 比 
比较 一 下 旧版 和 新 版 : 


lists/views.py 


def view list(request, list id): 
list = List.objects.get(id-list id) 
form = ExistinglistItemForm(for list-list ) 
if request.method -- 'POST': 
form = ExistingListItemForm(for list-list , data-request.POST) 
if form.is valid(): 
form.save() 
return redirect(list ) 
return render(request, 'list.html', ['list': list , "form": form}) 


虽然 新 版 代码 从 9 行 缩减 到 7 行 ， 但 我 还 是 觉得 基于 函数 的 视图 稍微 容易 理解 一 点 儿 ， 因 
为 旧版 没 隐 藏 那么 多 细节 ， 毕 况 “ 明 确 表述 比 含糊 其 辞 强 ”， 这 是 Python 的 禅 理 。 我 的 意 
思 是 ， 谁 知道 Single0bjectMixin 是 什么 呢 ? 而 且 更 讨厌 的 是 ， 如 果 在 get form 方法 中 不 
给 self.object 赋值 ， 整 个 类 都 不 能 用 。 这 一 点 太 烦 人 。 


不 过 ， 我 猜 有 些 人 喜欢 这 种 实现 方式 。 


B.6 为 CBGV 编 写 单元 测试 有 最 佳 实践 吗 

实现 这 个 视图 类 之 后 ， 我 发 现 有 些 单 元 测试 有 点 儿 太 关注 高 层 。 这 并 不 意外 ， 因 为 使 用 
Django 测试 客户 端的 视图 测试 或 许 更 应 该 叫 整合 测试 。 

测试 会 告诉 我 做 得 对 不 对 ， 但 不 能 始终 提示 有 具体 应 该 怎么 修正 错误 。 

有 时 ， 我 想 知道 有 设 有 一 种 编写 测试 的 方法 ， 更 贴近 实现 方式 ， 例 如 这 么 编写 测试 : 







































































lists/tests/test views.py 


def test cbv gets correct object(self): 
our list - List.objects.create() 
view - ViewAndAddToList() 
view.kwargs = dict(pk-our list.id) 
self.assertEqual(view.get object(), our list) 


但 这 么 做 有 个 问题 ， 必 须 对 Django CBV 的 内 部 机 理 有 一 定 了 解 ， 才 能 正确 设 定 这 种 测试 。 
而 且 最 后 还 是 会 被 复杂 的 继承 体系 弄 得 十 分 糊涂 。 


B7 ig: 编写 多 个 只 有 一 个 断言 的 隔离 视图 测试 
有 所 帮助 


在 这 个 附录 中 我 得 出 一 个 结论 : 编写 多 个 简短 的 单元 测试 比 编写 少量 含有 很 多 断言 的 测试 
有 用 得 多 。 
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看 看 这 个 庞大 的 测试 : 


lists/tests/test views.py 


def test validation errors sent back to home page template(self): 
response = self.client.post('/lists/new', data-(['text': ''}) 
self.assertEqual(List.objects.all().count(), 0) 
self.assertEqual(Item.objects.all().count(), 0) 
self.assertTemplateUsed(response, 'home.html') 
expected error - escape("You can't have an empty list item") 
self.assertContains(response, expected error) 


它 肯 定 没 有 下 面 这 3 个 单独 的 测试 有 用 : 














lists/tests/test views.py 
def test invalid input means nothing saved to db(self): 
self.post invalid input() 
self.assertEqual(List.objects.all().count(), 0) 
self.assertEqual(Item.objects.all().count(), 0) 


def test invalid input renders list template(self): 
response - self.post invalid input() 
self.assertTemplateUsed(response, 'list.html') 


def test invalid input renders form with errors(self): 
response - self.post invalid input() 
self.assertIsinstance(response.context['form'], ExistingListItemForm) 
self.assertContains(response, escape(empty list error)) 


因为 对 前 一 种 方式 来 说 ， 如 果 靠 前 的 断言 失败 了 ， 后 面 的 断言 就 不 会 执行 。 所以， 如 果 视 
图 不 小 心 把 POST 请 求 中 的 无 效 数据 存 入 数据 库 ， 前 面 的 断言 会 失败 ， 这 样 就 无 法 确认 使 
用 的 模板 是 否 正确 以 及 有 没有 泻 染 表单 。 使 用 后 一 种 方式 则 能 更 轻易 地 分 辨 出 到 底 哪 一 部 
分 能 用 ， 哪 一 部 分 不 能 



































从 CBGV 中 学 到 的 经 验 
。 基于 类 的 通用 视图 可 以 做 任何 事 
虽然 不 一 定 总 是 知道 到 底 怎么 回 事 ， 但 使 用 基于 类 的 视图 几乎 可 以 做 任何 事 。 
。 只 有 一 个 断言 的 单元 测试 有 助 于 重 构 
有 单元 测试 检查 什么 可 用 什么 不 可 用 ， 使 用 不 同 的 基本 范式 修改 视图 的 实现 方式 就 
容易 多 了 。 
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附录 C 


使 用 Ansible 配 置 服务 器 





用 Fabric 自动 把 新 版 源码 部 署 到 服务 器 上 ， 但 配置 新 服务 器 的 过 程 以 及 更 新 Nginx 和 
Gunicorn 配置 文件 的 操作 都 还 是 手动 完成 。 


这 类 操作 越 来 越 多 地 交 给 “配置 管理 ”或 “持续 部 署 ” 工 具 完 成 。 其 中 ，Chef 和 Puppet 
最 受 欢迎 ， 而 在 Python 领域 则 是 Salt 和 Ansible。 


在 这 些 工具 中 ，Ansible 最 容易 上 手 ， 只 需 两 个 文件 就 可 以 使 用 : 


pip2 install --user ansible # 可 惜 只 能 用 Python 2 












































清单 文件 deploy. tools/inventory.ansible 定义 可 以 在 哪些 服务 器 中 运行 : 








deploy_tools/inventory.ansible 
[live] 
superlists.ottg.eu ansible become-yes ansible ssh userzelspeth 


[staging] 
superlists-staging.ottg.eu ansible become-yes ansible ssh user-elspeth 


[local] 
localhost ansible ssh user-root ansible ssh port-6666 ansible host-127.0.0.1 


(local 条 目 只 是 个 示例 ， 在 我 的 设备 中 是 个 Virtualbox 虚拟 主机 ， 并 且 为 22 和 80 端口 设 
定 了 端口 转发 。) 
C.1 安装 系统 包 和 Nginx 


另 一 个 文件 是 “脚本 ”(playbook)， 定 义 在 服务 器 中 做 什么 。 这 个 文件 的 内 容 使 用 YAML 
句法 编写 : 
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deploy tools/provision.ansible.yaml 


- hosts: all 


vars: 
host: "{{ inventory hostname }}" 


tasks: 


- name: Deadsnakes PPA to get Python 3.6 
apt repository: 
repo-'ppa:fkrull/deadsnakes' 
- name: make sure required packages are installed 
apt: pkgeznginx,git,python3.6,python3.6-venv state-present 


- name: allow long hostnames in nginx 
lineinfile: 
dest-/etc/nginx/nginx.conf 
regexp='(\s+)#? ?server names hash bucket size' 
backrefszyes 
line-'Mserver names hash bucket size 64;' 


name: add nginx config to sites-available 
template: src-./nginx.conf.j2 dest-/etc/nginx/sites-available/[( host }} 
notify: 

- restart nginx 


- name: add symlink in nginx sites-enabled 
file: 
src-/etc/nginx/sites-available/([( host }} 
dest-/etc/nginx/sites-enabled/[( host 3) 
state-link 
notify: 
- restart nginx 


inventory hostname 变量 是 目标 服务 器 的 域名 。 为 了 方便 引用 ， 我 在 vars 部 分 把 它 重 命名 
成 了 “host”。 

在 “tasks” 部 分 ， 使 用 apt 安装 所 需 的 软件 ， 再 使 用 正则 表达 式 替 换 Nginx 配置 ， 允 许 
使 用 长 域名 ， 然 后 使 用 模板 创建 Nginx 配置 文件 。 这 个 模板 由 第 9 章 保 存在 deploy. tools/ 
nginx.template.conf 中 的 模板 文件 修改 而 来 ， 不 过 现在 指定 使 用 一 种 模板 引擎 
和 Django 的 模板 句法 很 像 : 




















Jinja2, 


deploy tools/nginx.conf.j2 


server { 
listen 80; 
server name {{ host }}; 


location /static { 
alias /home/{{ ansible ssh user }}/sites/{{ host }}/static; 
J 
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location / { 
proxy set header Host {{ host 3j); 
proxy pass http://unix:/tmp/([ host }}.socket; 


C.2 配置 Gunicorn， 使 用 处 理 程序 重启 服务 


脚本 剩余 的 内 容 如 下 : 
deploy tools/provision.ansible.yaml 


- name: write gunicorn service script 
template: 
src-./gunicorn.service.j2 
dest-/etc/systemd/system/gunicorn-([([ host }}.service 
notify: 
- restart gunicorn 


handlers: 
- name: restart nginx 
service: name-nginx state-restarted 


- name: restart gunicorn 
systemd: 
name-gunicorn-[[ host }} 
daemon reload-yes 
enabled-zyes 
state-restarted 


创建 Gunicorn 配置 文件 还 要 使 用 模板 : 
deploy tools/eunicorn.service.j2 


[Unit] 
Description-Gunicorn server for {{ host }} 


[Service] 
User-(( ansible ssh user }} 
WorkingDirectory-/home/([[ ansible ssh user }}/sites/{{ host }}/source 
Restart-on-failure 
ExecStart-/home/[( ansible ssh user }}/sites/{{ host j)/virtualenv/bin/gunicorn V 
--bind unix:/tmp/(( host j).socket V 
--access-logfile ../access.log V 
--error-logfile ../error.log V 
superlists.wsgi:application 


[Install] 
WantedBy-multi-user.target 


然后 定义 两 个 处 理 程 序 ， 重 启 Nginx 和 Gunicorn, Ansible 很 智能 ， 如 果 多 个 步骤 都 调用 同 
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个 处 理 程 序 ， 它 会 等 前 一 个 执行 完 再 调用 下 一 个 。 
这 样 就 行 了 ! 执行 配置 操作 的 命令 如 下 : 
ansible-playbook -i inventory.ansible provision.ansible.yaml --limit-staging --ask-become-pass 


详细 信息 参阅 Ansible 的 文档 。 


C.3 接 下 来 做 什么 


我 只 是 简单 介绍 了 Ansible 的 功能 。 部 署 过 程 的 自动 化 程度 越 高 ， 你 对 部 署 也 越 自 信 。 接 
下 来 ， 你 可 以 完成 下 面 几 件 事 。 


C.3.1 把 Fabric 执 行 的 部 署 操 作 交 给 Ansible 

已 经 看 到 Ansible 可 以 帮助 完成 配置 过 程 中 的 某 些 操作 ， 其 实 它 可 以 完成 几乎 所 有 部 署 操 
作 。 你 可 以 试 一 下 ， 看 能 否 扩 写 脚 本 把 当前 Fabric 部 署 脚本 中 的 所 有 操作 都 交 给 Ansible 
完成 ， 包 括 必 要 情况 下 重启 时 发 出 提醒 。 


C.3.2 ”使 用 Vagrant 搭 建 本 地 虚拟 主机 

在 过 渡 网 站 中 运行 测试 能 让 我 们 相信 网 站 上 线 后 也 能 正常 运行 。 不 过 也 可 以 在 本 地 设备 中 
使 用 虚拟 主机 完成 这 项 操作 。 
下 载 Vagrant 和 Virtualbox， 看 你 能 否 使 用 Vagrant 在 自己 的 电脑 中 搭建 一 个 开发 服务 器 ， 
以 及 使 用 Ansible 脚本 把 代码 部 署 到 这 个 服务 器 中 。 设 置 功能 测试 运行 程序 ， 让 功能 测试 
能 在 本 地 虚拟 主机 中 运行 。 

如 果 在 团队 中 工作 ， 编 写 一 个 Vagrant 配置 脚本 特别 有 用 ， 因 为 它 能 帮助 新 加 入 的 开发 者 
搭建 和 你 们 使 用 的 一 模 一 样 的 服务 器 。 
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测试 数据 库 迁移 




















Django-migrations 及 其 前 身 South 已 经 出 现 好 多 年 了 ， 所 以 一 般 没 必要 测试 数据 库 迁 移 。 
但 有 时 我 们 会 使 用 一 种 危险 的 迁移 ， 即 引入 新 的 数据 完整 性 约束 。 我 第 一 次 在 过 渡 环 境 中 
运行 这 种 迁移 脚本 时 ， 遇 到 了 一 个 错误 。 

在 大 型 项 目 中 ， 如 果 有 敏感 数据 ， 在 生产 数据 中 执行 迁移 之 前 ， 你 可 能 想 先 在 一 个 安全 的 
环境 中 测试 ， 增 加 一 些 自信 。 你 可 以 在 本 书 开发 的 示例 应 用 中 先 练习 一 下 。 


测试 迁移 的 另 一 个 常见 原因 是 测速 一 一 执行 迁移 时 经 常 要 把 网 站 下 线 ， 而 且 如 果 数 据 集 较 
大 ， 用 时 并 不 得。 所 以 最 好 提前 知道 迁移 要 执行 多 长 时 间 。 


D.1 尝试 部 署 到 过 渡 服务 器 
在 第 17 音 ， 当 我 第 一 次 尝试 部 署 新 添加 的 验证 约束 条 件 时 ， 遇 到 了 如 下 问题 ， 


$ cd deploy tools 
$ fab deploy:host-elspeth(superlists-staging.ottg.eu 
[. A] 
Running migrations: 
Applying lists.0005 list item unique together...Traceback (most recent call 
last): 
File "/usr/local/lib/python3.6/dist-packages/django/db/backends/utils.py", 
line 61, in execute 
return self.cursor.execute(sql, params) 
File 
" [usr/local/lib/python3.6/dist-packages/django/db/backends/sqlite3/base.py", 
line 475, in execute 
return Database.Cursor.execute(self, query, params) 
sqlite3.IntegrityError: columns list id, text are not unique 
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情况 是 这 样 ， 数 据 库 中 某 些 现 有 的 数据 违反 了 完整 性 约束 条 件 ， 所 以 当 我 尝试 应 用 约束 条 


MERT, Ha ESO T ^ii. 
为 了 处 理 这 种 问题 ， 需 要 执行 “数据 迁移 "。 首 先 ， 要 在 本 地 搭建 一 个 测试 环境 。 


D.2 在 本 地 执行 一 个 用 于 测试 的 迁移 


使 用 线 上 数据 库 的 副本 测试 迁移 。 


























测试 时 使 用 真实 数据 一 定 要 小 心 小 心 再 小 心 。 例 如 ， 数 据 中 可 能 有 客户 的 真 
实 电子 邮 件 地 址 ， 但 你 并 不 想 不 小 心 给 他 们 发 送 一 堆 测 试 邮 件 。 我 可 是 栽 过 
跟头 的 。 


D.2.1 输入 有 问题 的 数据 


在 线 上 网 站 中 新 建 一 个 清单 ， 输 入 一 些 重复 的 待 办 事项 ， 如 图 D-1 所 示 。 






































To-Do lists - Mozilla Firefox v 
File Edit View History Bookmarks Tools Help 
C To-Do lists [a] 
€ |@ superlist ottg.eu/lists » € | 图 " Google Q Ü e Xx 
list 
duplicate| 
1:a list with duplicate items 
2: duplicate 
3: duplicate 
4: duplicate 
加 x See 











图 D-1: 一 个 清单 ， 待 办 事项 有 重复 


D.2.2 ”从 线 上 网 站 中 复制 测试 数据 
从 线 上 网 站 中 复制 数据 库 : 


$ scp elspeth@superlists.ottg.eu:\ 
/home/elspeth/sites/superlists.ottg.eu/database/db.sqlite3 . 








测试 数据 库 迁 移 
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$ mv ../database/db.sqlite3 ../database/db.sqlite3.bak 
$ mv db.sqlite3 ../database/db.sqlite3 


D.2.3 确认 的 确 有 问题 
现在 ， 本 地 有 一 个 还 未 执行 迁移 的 数据 库 ， 而 且 数 据 库 中 有 一 些 问题 数据 。 如 果 莹 试 执 行 


migrate 命令 ， 会 看 到 一 个 错误 : 


$ python manage.py migrate --migrate 
python manage.py migrate 
Operations to perform: 
Lis] 
Running migrations: 
[5] 

Applying lists.0005 list item unique together...Traceback (most recent call 
last): 
[se] 

return Database.Cursor.execute(self, query, params) 

sqlite3.IntegrityError: columns list_id, text are not unique 


D.3 插入 一 个 数据 迁移 


数据 迁移 是 一 种 特殊 的 迁移 ， 目 的 是 修改 数据 库 中 的 数据 ， 而 不 是 变更 模式 。 应 用 完整 性 
约束 之 前 ， 先 要 执行 一 次 数据 迁移 ， 把 重复 数据 删除 。 具 体 方法 如 下 : 


$ git rm lists/migrations/0005 list item unique, together.py 
$ python manage.py makemigrations lists --empty 
Migrations for 'lists': 
0005 auto 20140414 2325.py: 
$ mv lists/migrations/0005 *.py lists/migrations/0005 remove, duplicates.py 


有 关 数 据 迁 移 的 详情 ， 请 参阅 Django 文档 。 下 面 是 修改 现 有 数据 的 方法 : 




















lists/migrations/0005 remove duplicates.py 


# encoding: utf8 
from django.db import models, migrations 


def find dupes(apps, schema editor): 
List - apps.get model("lists", "List") 
for list in List.objects.all(): 
items - list .item set.all() 
texts - set() 
for ix, item in enumerate(items): 
if item.text in texts: 
item.text = '{} ((J)'.format(item.text, ix) 
item.save() 
texts.add(item.text) 


class Migration(migrations.Migration): 
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dependencies - [ 
('lists', '0004 item list'), 
] 


operations - [ 
migrations.RunPython(find dupes), 


] 


重新 创建 以 前 的 迁移 


使 用 makemigrations 重新 创建 以 前 的 迁移 ， 确 保 这 是 第 6 个 迁移 ， 而 且 还 明确 依赖 于 0005, 
即 那个 数据 迁移 : 
$ python manage.py makemigrations 
Migrations for 'lists': 
0006 auto 20140415 0018.py: 
- Alter unique together for item (1 constraints) 
$ mv lists/migrations/0006 * lists/migrations/0006 unique, together.py 


D.4 一 起 测试 这 两 个 迁移 
现在 可 以 在 线 上 数据 中 测试 了 : 
$ cd deploy. tools 
$ fab deploy:host-elspethüsuperlists-staging.ottg.eu 


[5] 
还 要 重启 服务 器 中 的 Gunicorn 服务 : 





elspeth@server:$ sudo systemctl restart gunicorn-superlists.ottg.eu 
然后 可 以 在 过 渡 网 站 中 运行 功能 测试 : 
$ STAGING SERVER-superlists-staging.ottg.eu python manage.py test functional tests 
EFEN 
Ran4testsin17.308s 
OK 
看 起 来 一 切 正常 。 现 在 部 署 到 线 上 服务 器 : 


$ fab deploy --host=superlists.ottg.eu 
[superlists.ottg.eu] Executing task 'deploy' 


[52] 


最 后 ， 执 行 git add lists/migrations, git commit 等 命令 。 
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D.5 小 结 


迁移 的 十 万 种 方式 之 





个 练习 的 主要 目的 是 编写 一 个 数据 迁移 ， 在 一 些 真 实 的 数据 中 测试 。 当 然 ， 这 只 是 济 
。 你 还 可 以 编写 自动 化 测试 ， 比 较 运 行 迁移 前 后 数据 库 中 的 内 











容 ， 人 确认 数据 还 在 。 也 可 以 为 数据 迁移 中 的 辅助 函数 单独 编写 单元 测试 。 你 可 以 再 多 花 


点 儿 时 间 统 计 迁 移 所 月 


月 的 时 间 ， 然 后 实验 多 种 提速 的 方法 ， 例 如 ， 把 迁移 的 步骤 分 得 更 





细 或 更 党 统 


记 住 ， 这 种 需求 很 少见 。 根 据 我 的 多 





经 验 ， 我 使 用 的 迁移 有 9990 都 不 需要 测试 。 不 过 ， 在 你 


的 项 目 中 可 能 需要 。 和 希望 读 过 这 个 附录 之 后 ， 你 知道 怎么 着 手 测 试 迁 移 。 








关于 测试 数据 库 迁 移 

小 心 引入 约束 的 迁移 

99% 的 迁移 者 没 问 题 ， 但 是 如 果 迁 移 为 现 有 的 列 引 入 了 新 的 约束 条 件 ， 就 像 前 面 那 
个 例子 ， 一 定 要 小 心 。 

测试 迁移 的 执行 速度 

一 旦 项 目 变 大 ， 你 就 应 该 考虑 测试 迁移 所 用 的 时 间 。 执 行 数据 库 迁 移 时 往往 要 下 线 
网 站 ， 因 为 修改 模式 可 能 要 锁定 数据 表 (取决 于 使 用 的 数据 库 种 类 )， 直 到 操作 完 
成 为 止 。 所 以 最 好 在 过 渡 网 站 中 测试 迁移 要 用 多 长 时 间 。 


使 用 生产 数据 的 副本 时 要 格外 小 心 

为 了 测试 迁移 ， 要 在 过 渡 网 站 的 数据 库 中 填充 与 生产 数据 等 量 的 数据 。 具体 怎 么 做 
不 在 本 书 范畴 之 内 ， 不 过 我 要 提醒 一 下 : 如 果 直 接 转 储 生产 数据 库 导 入 过 渡 网 站 的 
数据 库 中 ， 一定 要 十 分 小 心 ， 因 为 生产 数据 中 包含 真实 客户 的 详细 信息 。 有 一 次 在 
过 渡 服 务 器 中 自动 处 理 刚 导 入 的 生产 数据 副本 时 ， 我 不 小 心 发 送 了 好 几 百 张 错误 的 
发 票 。 那 个 下 午 过 得 可 不 愉快 。 
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附录 E 


行为 驱动 开发 





行为 驱动 开发 (behaviour-driven development, BDD) 我 用 得 不 多 ， 算 不 上 什么 专家 ,但 
就 目前 我 所 接触 的 ， 我 认为 值得 简要 介绍 一 下 。 本 附录 将 使 用 BDD 工具 转换 一 些 “ 常 规 
的 ”功能 测试 。 


E.1 BDD 是 什么 


严格 来 说 ，BDD 是 一 种 方法 论 ， 而 不 是 工具 集 。BDD 测试 的 是 应 用 的 行为 ， 确 定 是 否 与 
我 们 期 望 用 户 看 到 的 一 致 。 因 此 ， 本 书展 示 的 部 分 基于 Selenium 的 功能 测试 其 实 也 可 以 称 
为 BDD。 

但 这 种 测试 方法 通常 与 BDD 采用 的 特定 工具 集 联 系 紧 密 ， 其 中 最 重要 的 是 Gherkin 句法 ， 
这 是 编写 功能 测试 〈 或 验收 测试 ) 的 DSL， 对 人 类 而 言 可 读 性 高 。Gherkin 源 自 Ruby 世 
界 ， 与 名 为 Cucumber 的 测试 运行 程序 捆绑 。 

在 Python 世界 ， 有 几 个 等 效 的 测试 运行 工具 ， 例 如 Lettuce 和 Behave。 目 前 为 止 ， 只 

Behave 兼容 Python 3， 因 此 我 们 将 使 用 它 。 此 外 ， 还 将 使 用 一 个 插件 behave-django。 












































获取 示例 代码 
我 将 使 用 第 22 章 的 示例 。 待 办 事项 清单 网 站 已 经 具备 基本 功能 ， 我 们 想 添加 一 个 新 功 
能 : 已 登录 用 户 应 该 能 在 某 个 地 方 查 看 自己 编制 的 清单 。 在 此 之 前 ， 所 有 清单 都 是 匿 
名 创建 的 。 
如 果 你 一 直 跟 着 本 书 操 作 ， 我 假设 你 能 跳 回 到 那 一 点 。 如 果 想 从 我 的 仓库 中 拉 取 ， 要 
使 用 chapter 17 分 支 。 
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E2 基本 的 准备 工作 


下 面 为 BDD 特性 描述 创建 一 个 features 目录 ， 在 里 面 再 添加 一 个 steps 目录 (马上 告诉 你 
它 的 作用 )， 并 为 这 个 新 功能 创建 一 个 占 位 文件 : 


$ mkdir -p features/steps 
$ touch features/my lists.feature 
$ touch features/steps/nmy, lists.py 
$ tree features 
features 
I— ny. lists.feature 
L— steps 
L— my lists.py 

















然后 安装 behave-django， 并 把 它 添加 到 settings.py 中 : 
$ pip install behave-django 


superlists/settings.py 


- a/superlists/settings.py 
+++ b/superlists/settings.py 
@@ -40,6 +40,7 @@ INSTALLED APPS = [ 
'lists', 
'accounts', 
'functional tests', 
十 'behave django', 


] 
最 后 运行 python manage.py， 做 健全 性 检查 : 


$ python manage.py behave 

Creating test database for alias 'default'... 

0 features passed, 0 failed, 0 skipped 

0 scenarios passed, 0 failed, 0 skipped 

0 steps passed, 0 failed, © skipped, © undefined 
Took 0m0.000s 

Destroying test database for alias 'default'... 


E.3 使 用 Gherkin 句 法 以 “特性 描述 ”的 形式 编 


mm Lb SI 

写 功 能 测试 
目前 ， 我 们 的 功能 测试 使 用 人 类 可 读 的 注释 描述 新 功能 ， 这 叫 用 户 故 事 ， 其 间 穿 插 着 执行 
故事 中 每 一 步 的 Selenium 代码 。 
BDD 要 求 严 格 区 分 这 二 者 : 先 使 用 Gherkin 句法 (有 时 让 人 觉得 描 口 ) 编写 人 类 可 读 的 故 
事 ， 这 叫 “ 特 性 描述 ”(feature) ; 然后 ， 把 每 一 行 Gherkin 代码 映射 到 一 个 函数 上 ， 那 个 
函数 包含 实现 那 一 “ 步 ”(step) 所 需 的 Selenium 代码。 


“My Lists” 页 面 这 个 新 功能 的 特性 描述 可 以 写成 下 面 这 样 : 
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features/my lists.feature 


Feature: My Lists 
As a logged-in user 
I want to be able to see all my lists in one page 
So that I can find them all after I've written them 


Scenario: Create two lists and see them on the My Lists page 

Given I am a logged-in user 

When I create a list with first item "Reticulate Splines" 
And I add an item "Immanentize Eschaton" 
And I create a list with first item "Buy milk" 

Then I will see a link to "My lists" 

When I click the link to "My lists" 

Then I will see a link to "Reticulate Splines" 


And I will see a link to "Buy milk" 


When I click the link to "Reticulate Splines" 
Then I will be on the "Reticulate Splines" list page 


E.3.1 As-a/l want to/So that 


顶部 是 “As-a/I want to/So that” 子 句 。 这 部 分 是 可 选 的 ， 没 有 对 应 的 可 执行 代码 。 这 只 是 
一 种 形式 ， 让 用 户 知道 “你 是 谁 、 你 想 做 什么 ” ， 有 助 于 团队 成 员 理解 每 个 功能 的 背景 。 

















E.3.2 Given/When/Then 


“Given/When/Then ”是 BDD 测试 的 真正 核心 。 这 三 部 分 与 单元 测试 的 “设置 -使 用 - 断 
言 ” 模 式 匹配 ， 分 别 表示 设置 /假设 阶段 、 使 用 /行动 阶段 以 及 断言 /观察 阶段 。 详 情 参见 
Cucumber 维基 页 面 (https://github.com/cucumber/cucumber/wiki/Given-When-Then) 。 


E.3.3 ”并 不 始终 完美 契合 


如 你 所 见 ， 用 户 故 事 不 是 总 能 完美 分 成 这 三 步 的 。 我 们 可 以 使 用 And 子 句 扩充 步骤 ， 而 且 
我 还 添加 了 多 个 When 和 随后 的 Then 子 句 ， 进 一 步 描 绘 “My Lists” 页 面 。 


E.4 编写 步骤 函数 


下 面 编写 Gherkin 句法 描述 的 特性 对 应 的 “步骤 ”函数 ， 即 真正 使 用 代码 实现 。 


生成 占 位 步骤 


运行 behave， 它 会 告诉 我 们 需要 实现 的 每 一 步 ， 
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$ python manage.py behave 

Feature: My Lists # features/my lists.feature:1 
As a logged-in user 
I want to be able to see all my lists in one page 
So that I can find them all after I've written them 


Scenario: Create two lists and see them on the My Lists page # 
features/my lists.feature:6 
Given I am a logged-in user # None 
Given I am a logged-in user # None 
When I create a list with first item "Reticulate Splines" None 
And I add an item "Immanentize Eschaton" # None 
And I create a list with first item "Buy milk" # None 
Then I will see a link to "My lists" # None 
When I click the link to "My lists" # None 
Then I will see a link to "Reticulate Splines" # None 
And I will see a link to "Buy milk" # None 
When I click the link to "Reticulate Splines" # None 
Then I will be on the "Reticulate Splines" list page # None 


Failing scenarios: 
features/my lists.feature:6 Create two lists and see them on the My Lists 


page 


0 features passed, 1 failed, 0 skipped 

0 scenarios passed, 1 failed, © skipped 

0 steps passed, 0 failed, © skipped, 10 undefined 
Took 0m0.000s 


You can implement step definitions for undefined steps with these snippets: 
(given(u'I am a logged-in user') 
def step impl(context): 


raise NotImplementedError(u'STEP: Given I am a logged-in user') 


(Qwhen(u'I create a list with first item "Reticulate Splines"') 
def step impl(context): 


EM 
而 且 你 会 发 现 ， 输 出 有 不 同 的 颜色 ， 如 图 E-1 所 示 。 
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PTS harry Gharry-samsung-linux: -/Dropbox/book/source/appendix bdd/superlists 


File Edit View Search Terminal Help 
(y sUperlists-bdd V appendix-bdd RY A OF 


© python manage.py behave 
Creating test database for alias 'default'... 
Feature: My Lists 
As a Logged-in user 
I want to be able to see all my Lists in one page 
So that I can find them all after I've written them 
Scenario: Create two Lists and see them on the My Lists page 


Not Found: /404.no.such.-urL/ 
Not Found: /favicon.ico 


Failing scenarios: 
features/my-Lists.feature:6 Create two Lists and see them on the My Lists pase 





|o features passed, 1 failed, O skipped 








图 E-1: Behave 在 控制 台 输出 带 有 不 同 颜色 的 内 容 
Behave 建议 我 们 复制 粘贴 这 些 片 段 ， 在 此 基础 上 构建 步 又 。 


E.5 定义 第 一 步 


下 











HANKEL “Given I am a logged-in user” 这 一 步 。 我 直接 从 functional_tests/test_my_lists.py 











中 复制 self.create_pre_authenticated_session 的 代码 ， 然 后 稍 做 调整 (例如 删 掉 服务 器 
端 版 本 ， 不 过 后 面 再 加 上 也 容易 )。 


features/steps/my lists.py 


from behave import given, when, then 

from functional tests.management.commands.create session import V 
create pre authenticated session 

from django.conf import settings 


(Qgiven('I am a logged-in user') 

def given i am logged in(context): 
session key = create pre authenticated session(email-'edith(jexample.com') 
1H 为 了 设 定 cookie， 我 们 要 先 访问 网 站 
AE 而 404 页 面 是 加 载 最 快 的 
context.browser.get(context.get url("/404 no such url/")) 
context.browser.add cookie(dict( 
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name-settings.SESSION COOKIE NAME, 
value-session key, 
pathz'/', 

)) 


context 变量 需要 稍 做 说 明 : 它 有 点 像 是 全 局 变量 ， 因 为 我 们 将 通过 它 存 储 在 步骤 之 间 共 享 
的 信息 ， 把 它 传 给 要 执行 的 每 一 步 。 这 里 ， 我 们 假定 它 存 储 了 一 个 浏览 器 对 象 和 server url, 
我 们 将 多 次 使 用 这 个 变量 ， 就 像 在 使 用 unittest 编写 功能 测试 时 经 常 使 用 self 一 样 。 














E.6 environment.py 中 与 setUp 和 tearDown 等 价 
的 函数 


各 步 可 以 修改 context 中 的 状态 ， 不 过 前 期 准备 工作 ， 即 与 setup 等 价 的 操作 ， 在 
environment.py 文件 中 设置 ; 


features/environment.py 


from selenium import webdriver 


def before all(context): 
context.browser - webdriver.Firefox() 


def after all(context): 
context.browser.quit() 


def before feature(context, feature): 
pass 


E.7 再 次 运行 
可 以 再 运行 一 次 ， 做 健全 性 检查 ， 人 确认 新 编写 的 步骤 是 否 可 行 ， 以 及 能 否 启动 浏览 器 : 
$ python manage.py behave 


[...] 
1 step passed, 0 failed, © skipped, 9 undefined 


输出 的 内 容 很 多 ， 不 过 可 以 看 到 ， 第 一 步 通过 了 。 下 面 定义 余下 的 步骤 。 


E.8 在 步骤 中 捕获 参数 
我 们 将 说 明 如 何在 步骤 描述 中 捕获 参数 。 接 下 来 的 一 步 是 : 








features/my lists.feature 


When I create a list with first item "Reticulate Splines" 


自动 生成 的 步骤 定义 如 下 : 
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features/steps/my lists.py 


Qgiven('I create a list with first item "Reticulate Splines"') 
def step impl(context): 
raise NotImplementedError( 
u'STEP: When I create a list with first item "Reticulate Splines"' 


) 
我 们 希望 以 任意 的 第 一 个 待 办 事项 创建 清单 。 所 以 ， 如 果 能 通过 某 种 方式 捕获 双 引 号 中 的 
内 容 就 好 了 ， 这 样 就 可 以 把 它 作 为 参数 传 给 更 为 通用 的 函数 。 这 是 BDD 的 一 个 常见 需求 ， 
Behave 为 此 提供 了 优雅 的 句法 。 还 记得 Python 为 字符 串 格式 化 提供 的 新 名 法 吗 ? 











features/steps/my lists.py (ch351006) 
ee 


@when('I create a list with first item "{first item text}"') 

def create a list(context, first item text): 
context.browser.get(context.get url('/')) 
context.browser.find element by id('id text').send keys(first item text) 
context.browser.find element by id('id text').send keys(Keys.ENTER) 
wait for list item(context, first item text) 


很 棒 吧 ? 


在 步骤 中 捕获 参数 是 BDD 句法 最 为 强大 的 功能 之 一 。 








与 在 Selenium 测试 中 一 样 ， 我 们 要 显 式 等 待 。 依 旧 使 用 base.py 中 的 @wait 装饰 器 : 


features/steps/my lists.py (ch351007) 


from functional tests.base import wait 


[27] 


(wait 
def wait for list item(context, item text): 
context.test.assertIn( 
item text, 
context.browser.find element by css selector('stid list table').text 


) 
与 之 类 似 ， 我 们 也 可 以 把 待 办 事项 添加 到 现 有 清单 中 ， 查 看 或 点 击 链接 : 





features/steps/my lists.py (ch351008) 


from selenium.webdriver.common.keys import Keys 


[...] 


(Qwhen('I add an item "(item text]"') 
def add an item(context, item text): 
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context.browser.find element by id('id text').send keys(item text) 
context.browser.find element by id('id text').send keys(Keys.ENTER) 
wait for list item(context, item text) 


Qthen('I will see a link to "(link text]"') 

(wait 

def see a link(context, link text): 
context.browser.find element by link text(link text) 


(Qwhen('I click the link to "(link text]"') 
def click link(context, link text): 
context.browser.find element by link text(link text).click() 


注意 ， 我 们 甚至 可 以 在 步骤 上 使 用 @wait 装饰 器 。 
最 后 是 稍微 复杂 一 些 的 步骤 ， 描 述 自己 在 某 个 清单 的 页 面 上 : 
































features/steps/my lists.py (ch351009) 


QGthen('I will be on the "(first item text)" list page') 
(wait 
def on list page(context, first item text): 
first row - context.browser.find element by css selector( 
'#id_ list table tr:first-child' 
) 
expected row text = '1: * first item text 
context.test.assertEqual(first row.text, expected row text) 


现在 运行 ， 得 到 第 一 个 预期 失败 : 


$ python manage.py behave 


Feature: My Lists # features/my_lists.feature:1 
As a logged-in user 
I want to be able to see all my lists in one page 
So that I can find them all after I've written them 
Scenario: Create two lists and see them on the My Lists page £ 
features/my lists.feature:6 
Given I am a logged-in user # 
features/steps/my lists.py:19 
When I create a list with first item "Reticulate Splines" # 
features/steps/my lists.py:31 


And I add an item "Immanentize Eschaton" # 
features/steps/my_lists.py:39 

And I create a list with first item "Buy milk" # 
features/steps/my_lists.py:31 

Then I will see a link to "My lists" # 


functional_tests/base.py:12 
Traceback (most recent call last): 
Eta] 
File "features/steps/my_lists.py", line 49, in see_a_link 
context.browser.find element by link text(link text) 
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selenium.common.exceptions.NoSuchElementException: Message: Unable to 


locate element: My lists 


Wwe 


] 


Failing scenarios: 


features/my lists.feature:6 Create two lists and see them on the My Lists 
page 


0 features passed, 1 failed, © skipped 
O0 scenarios passed, 1 failed, © skipped 
4 steps passed, 1 failed, 5 skipped, 0 undefined 


从 输出 可 以 看 出 ,我们 在 “用 户 故 事 ” 上 走 了 多 远 : 我 们 成 功 创建 了 两 个 清单 ， 但 是 “My Lists" 
链接 未 出 现 。 


E.9 与 行 间 式 功能 测试 比较 























我 不 会 完整 实现 整个 功能 ， 不 过 你 可 以 看 出 ， 这 与 行 间 式 功 能 测试 一 样 ， 能 驱动 我 们 向 前 





下 


开发 。 

















夺回 


顾 一 下 行 间 测 试 ， 比 较 一 下 : 


functional tests/test my lists.py 


def test logged in users lists are saved as my lists(self): 


# 伊 迪 丝 是 已 登录 用 户 
self.create pre authenticated session('edithQexample.com') 


# 她 访问 首页 ， 新 建 一 个 清单 
self.browser.get(self.live server url) 
self.add list item('Reticulate splines') 
self.add list item('Immanentize eschaton') 
first list url = self.browser.current url 


# 她 第 一 次 看 到 “My Lists" BERE 
self.browser.find element by link text('My lists').click() 


# 她 看 到 这 个 页 面 中 有 她 创建 的 清单 
# 而 且 清 单 根据 第 一 个 待 办 事项 命名 
self.wait for( 

lambda: self.browser.find element by link text('Reticulate splines') 





























) 


self.browser.find element by link text('Reticulate splines').click() 
self.wait for( 
lambda: self.assertEqual(self.browser.current url, first list url) 


) 
# 她 决定 再 建 一 个 清单 试 试 


self.browser.get(self.live server url) 
self.add list item('Click cows') 
second list url - self.browser.current url 
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# 这 个 新 建 的 清单 也 在 “My 
self.browser.find element by link text('My lists').click() 


self. 


wait for( 











Lists” 页 面 显示 出 来 了 


lambda: self.browser.find element by link text('Click cows') 


) 


self.browser.find element by link text('Click cows').click() 


self. 


wait for( 


lambda: self.assertEqual(self.browser.current url, second list url) 


) 


# 她 退出 后 ，“My Lists” 链 接 不 见 了 

self.browser.find element by link text('Log out').click() 

self.wait for(lambda: self.assertEqual( 
self.browser.find elements by link text('My lists'), 


[ 
)) 





] 


虽然 不 能 一 一 对 应 比较 ， 但 是 可 以 看 看 代码 行 数 ， 见 表 E-1。 
表 E-1: 比较 代码 行 数 


BDD 


标准 的 功能 测试 





特性 描述 文件 : 20 (3 个 可 选 ) ”测试 
步骤 文件 ;56 行 











辅助 


函数 的 主体 : 45 
国 数 : 23 





这 样 比较 并 不 严谨 ， 但 是 可 以 认为 特性 描述 文件 和 “标准 的 功能 测试 ”的 测试 函数 主体 是 





等 价 的 ， 都 表示 测试 的 主体 “故事 ”"， 而 步 又 定义 和 辅助 函数 表示 “隐藏 的 ”实现 细 市 。 
如 果 把 行 数 加 在 一 起 ， 总 行 数 相差 不 多 ， 但 是 二 者 的 结果 不 一 样 : BDD 测试 写 出 的 故事 更 
简洁 ， 而 且 更 多 内 容 隐藏 到 实现 细节 中 了 。 


E.10 ”BDD 得 到 的 测试 代码 结构 更 好 


对 我 而 言 ， 真 正 吸 引 人 的 是 ，BDD 工具 人 迫使 我 们 思考 测试 代码 的 结构 。 在 行 间 式 功能 测试 
中 ， 实 现 需 要 多 少 行 代 码 就 可 以 写 多 少 行 ， 用 户 故 事 是 通过 注释 描述 的 。 我 们 很 难 控制 自 
己 不 从 别处 或 同一 个 测试 的 前 面 复制 粘贴 代码 。 到 目前 为 止 ， 你 可 以 看 到 ， 我 只 定义 了 几 
个 辅助 函数 (例如 get item input box), 





与 之 相 比 ，BDD 句法 则 强 秆 


。 新 建 清单 


























。 把 待 办 事项 添加 到 现 有 清单 中 。 


。 点 击 特定 文本 的 链接 
。 断言 我 在 查看 某 个 清 


的 代码 与 业务 逻辑 匹配 得 更 好 ， 而 且 能 分 层 抽象 ， 把 功能 测试 的 故事 与 实 


通过 BDD 5H 




















现 的 代码 分 开 。 


这 样 做 最 终 的 好 处 是 ， 如 果 想 更 换 编程 语言 ， 理 论 上 可 以 原样 保留 Gherkin 句法 编写 的 特 
性 描述 ， 丢 掉 Python 代码 实现 的 步骤 ， 再 用 新 语言 重新 编写 。 








单 的 页 面 。 














| 我 们 为 每 一 步 编写 单独 的 函数 ， 因 此 很 多 代码 都 是 可 以 重用 的 。 
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E11 与 页 面 模 式 比较 


第 25 章 举 了 一 个 使 用 “页 面 模式 ”的 示例 。 页 面 模 式 是 组 织 Selenium 测试 的 面向 对 象 方 
式 。 下 面 回顾 一 下 它 的 用 法 ， 



































functional tests/test sharing.py 


from .lists page import ListsPage 


[225] 
class SharingTest(FunctionalTest): 


def test can share a list with another user(self): 
$-D...] 
self.browser.get(self.live server url) 
list page - ListPage(self).add list item('Get help') 


# 她 看 到 “分 享 这 个 清单 ”选项 
share box = list page.get share box() 
self.assertEqual( 
share box.get attribute('placeholder'), 
' your -friendQexample.com' 





) 
# 她 分 享 自己 的 清单 之 后 ， 页 面 更 新 了 


# 提示 已 经 分 享 给 Oniciferous 
list page.share list with('oniciferous@example.com') 


Page 类 的 定义 如 下 : 

















functional tests/lists pages.py 
class ListPage(object): 
def init (self, test): 
self.test - test 


def get table rows(self): 
return self.test.browser.find elements by css selector('stid list table tr') 


(wait 
def wait for row in list table(self, item text, item number): 
row text = '{}: (j'.format(item number, item text) 


rows - self.get table rows() 
self.test.assertIn(row text, [row.text for row in rows]) 


def get item input box(self): 
return self.test.browser.find element by id('id text') 


可 以 看 出 ， 不 管 是 使 用 页 面 模式 还 是 其 他 结构 ， 完 全 可 以 在 行 间 式 功能 测试 中 做 同样 的 抽 
象 ， 实 现 某 种 DSL。 但 是 ， 我 们 应 该 自律 ， 而 不 能 靠 框架 去 约束 。 
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实在 BDD HF eTULDE Hl RARER, EKAP o8 E E DU, d xs rn B 
页 面 。 


N 


Ab ~ 4 IN MPG ` 
E.12 BDD 可 能 没有 行 间 注释 的 表达 力 强 
另 一 方面 ， 我 觉得 Gherkin 句法 有 点 不 够 灵活 。 行 间 式 注释 表达 力 强 ， 而 且 可 读 性 高 ， 但 
BDD BJ PEPERDA IA : 





functional tests/test my lists.py 

















# 伊 迪 丝 是 已 登录 用 户 

# 她 访问 首页 ， 新 建 一 个 清单 

# 她 第 一 次 看 到 “My Lists” 链 接 

# 她 看 到 这 个 页 面 中 有 她 创建 的 清单 

# 而 且 清 单 根据 第 一 个 待 办 事项 命名 

# 她 决定 再 建 一 个 清单 试 试 

# 这 个 新 建 的 清单 在 “My Lists” 页 面 也 显示 出 来 了 

# 她 退出 后 ，“My Lists” 链 接 不 见 了 

[zx] 

与 呆板 的 “Given/Then/When” 结 构 相 比 ， 功 能 测试 中 的 行 间 注 释 可 读 性 更 高 ， 也 显得 更 
自然 ， 而 且 在 一 定 程度 上 ， 更 能 从 用 户 的 角度 思考 问题 。(Gherkin 也 支持 在 特性 描述 文件 
中 编写 “注释 " ， 这 能 在 一 定 程 度 上 缓解 上 述 问 题 ， 但 是 我 想 用 的 人 并 不 多 。) 


E.13 非 程 序 员 会 编写 测试 吗 


有 一 点 我 还 没有 提 到 : BDD 最 初 的 动机 之 一 是 让 非 程序 员 (可 能 是 业务 代表 或 客户 代表 ) 
能 够 编写 Gherkin 句法 。 我 十 分 怀疑 现实 中 有 没有 人 这 么 做 ， 即 便 有 ， 与 BDD 的 其 他 优势 
相 比 ， 我 想 这 也 不 算 什 么 。 


E.14 目前 的 结论 


我 才刚 接触 BDD， 还 不 能 得 出 什么 强 有 力 的 结论 。 我 觉得 “强制 ”把 功能 测试 分 成 不 同 的 
步骤 十 分 吸引 人 ， 因 为 这 样 便于 在 功能 测试 中 大 量 重用 代码 ， 而 且 能 把 关注 点 明确 分 开 
一 边 是 对 故事 的 描述 ， 另 一 边 是 具体 实现 。 此 外 ，BDD 还 能 让 我 们 站 在 业务 逻辑 的 角度 思 
考 问 题 ， 而 不 是 想 着 “应 该 如 何 使 用 Selenium 去 做 ”。 

但 是 ， 世 界 上 没有 免费 的 午餐 。 与 功能 测试 中 行 间 注 释 的 无 拘 无 束 相 比 ，Gherkin 句法 太 
死板 、 不 够 灵活 。 

我 还 想 知道 ， 当 功能 描述 由 一 两 个 变 成 十 儿 个 、 步 又 定义 由 四 五 个 变 成 几 百 行 代码 之 后 ， 
BDD 能 否 适应 。 

总 之 ， 我 觉得 BDD 绝对 值得 深入 研究 ， 我 的 下 一 个 个 人 项 目 可 能 会 使 用 它 。 
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感谢 Daniel Pope, Rachel Willmer 和 Jared Contrascere 对 本 附录 的 反馈 。 





BDD 总 结 


。 有 助 于 编写 结构 良好 、 可 重用 的 测试 代码 
BDD 能 分 离 关 注 点 ， 把 功能 测试 拆 分 成 人 类 可 读 的 “特性 描述 ”文件 (使 用 
Gherkin 负 法 ) 和 步骤 函数 的 实现 ， 这 样 有 助 于 编写 可 重用 、 易 于 管理 的 测试 代码 。 
。 可 能 有 失 可 读 性 
Gherkin 向 法 虽然 追求 的 是 人 类 可 读 性 ， 但 是 并 没有 充分 发 挥 人 类 语言 的 灵活 性 
因此 可 能 无 法 像 行 间 注释 那样 注重 细节 、 明 确 表 明 意 图 。 
。 多 尝试 总 是 好 的 
我 不 断 强 调 ， 我 还 未 在 真实 的 项 目 中 用 过 BDD， 因 此 你 要 对 我 讲 的 内 容 持 怀疑 态 
度 。 但 是 我 强烈 推荐 你 使 用 BDD。 我 将 试 着 在 我 的 下 一 个 项 目 中 使 用 它 ， 同 时 也 
建议 你 这 么 做 。 
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附录 FF 
构建 一 个 REST API: JSON、Ajax 和 


JavaScript 模 拟 技术 





表现 层 状 态 转 化 (REpresentational State Transfer REST) 是 一 种 设计 Web 服务 的 方案 ， 
读 取 和 更 新 的 是 “资源 ”(resource)。 设 计 通 过 Web 使 用 的 API 时 ， 这 是 首选 方案 。 


我 们 设计 的 Web 应 用 还 用 不 到 API， 那 为 什么 现在 就 要 设计 一 个 呢 ? 其 中 一 个 动机 是 想 让 
网 站 更 加 动态 ， 从 而 提升 用 户 体 验 。 在 清单 中 添加 待 办 事项 后 ， 我 们 不 想 等 待 页 面 刷 新 ， 
而 是 想 使 用 JavaScript 向 API 发 送 异 步 请 求 ， 让 用 户 感受 网 站 的 交互 性 。 

但 更 重要 的 一 点 或 许 是 ， 有 了 API， 我 们 就 可 以 通过 浏览 器 之 外 的 机 制 与 后 端 应 用 交互 。 
例如 ， 客 户 端 可 以 是 移动 应 用 ， 也 可 以 是 命令 行 应 用 ， 而 且 其 他 开发 者 还 可 以 围绕 后 端 构 
建 库 和 工具 。 

本 附录 将 说 明 如 何 自 己 动手 构建 一 个 API。 附 录 G 再 介绍 Django 生态 系统 中 的 一 个 流行 
工具 

















Django-Rest-Framework, 


F.1 本 附录 采用 的 方案 


我 们 构建 的 API 不 涵盖 应 用 的 全 部 功能 ， 而 是 假设 已 经 有 清单 了 。 根 据 REST 架构 ，URL 
和 HTTP 方 法 (常用 的 有 GET 和 POST， 不 过 也 有 比较 少 用 的 ， 例 如 PUT 和 DELETE) 
之 间 有 一 定 的 对 应 关系 ， 我 们 可 以 据 此 设计 方案 。 

维基 百科 中 的 REST 词 条 对 此 有 很 好 的 概述 ， 简 单 来 说 : 
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。 新 URL 结构 为 /api/lists/{id}/; 
。 通过 GET 请 求 获取 请 单 详 情 (包括 清单 中 的 全 部 待 办 事项 ) 的 JSON 格式 ， 
。 通过 POST 请 求 添加 待 办 事项 。 


我 们 将 使 用 第 25 章 结束 时 的 代码 。 


F.2 选择 测试 方案 

如 果 构 建 的 API 对 客户 端 一 无 所 知 ， 或 许 应 该 好 好 想 想 测试 应 该 下 行 到 哪 一 层 。 对 功能 测 
试 来 说 ， 我 们 仍然 要 启动 一 个 真实 的 服务 器 (可 以 使 用 LiveserverTestCase), 然后 使 用 
requests 库 与 之 交互 。 我 们 应 该 仔细 考虑 如 何 设置 固件 (如果 使 用 API 自身 ， 测 试 之 间 牵 
涉 的 依赖 太 多 )， 以 及 哪 一 层 的 单元 测试 对 我 们 最 有 用 。 或 者 , 干脆 只 使 用 Django 测试 客 
户 端 做 一 层 测 试 。 

现在 的 情况 是 ， 我 们 要 为 基于 浏览 器 的 客户 端 构建 API。 我 们 想 在 线 上 网 站 使 用 这 个 API, 
而 且 对 应 用 之 前 的 功能 没有 任何 影响 。 因 此 ， 我 们 依然 要 让 功能 测试 做 最 高 层 的 测试 ， 通 
过 功能 测试 检查 JavaScript 和 API 之 间 的 集成 情况 。 

这 样 一 来 ， 低 层 测试 就 要 使 用 Django 测试 客户 端 了 。 下 面 开始 构建 。 


F.3 基本 结构 


首先 ， 编 写 一 个 功能 测试 ， 检 查 新 的 URL 结构 能 正常 响应 GET 请 求 (状态 码 为 200) ， 而 
且 响 应 是 JSON 格式 (而 不 是 HTML 格式 ) : 



































= 









































lists/tests/test_api.py 
import json 


from django.test import TestCase 


from lists.models import List, Item 


class ListAPITest(TestCase): 
base_url = '/api/lists/{}/' © 


def test_get_returns_json_200(self): 
list_ = List.objects.create() 
response = self.client.get(self.base_url.format(list_.id)) 
self.assertEqual(response.status code, 200) 
self.assertEqual(response['content-type'], 'application/json') 


@ 使 用 类 级 常量 指定 URL 是 本 附录 采用 的 新 方式 ， 这 样 做 便 无 须 重 复 硬 编码 URL, Jt 
外 ， 还 可 以 调用 reverse， 进 一 步 减 少 重复 。 


然后 ， 引 入 urls x ff: 

















构建 一 个 REST API: JSON、Ajax 和 JavaScript 模 拟 技术 | 417 


super lists/urls.py 


from django.conf.urls import include, url 
from accounts import urls as accounts urls 
from lists import views as list views 

from lists import api urls 

from lists import urls as list urls 


urlpatterns - [ 
url(r'^$', list views.home page, name-'home'), 
url(r'^lists/', include(list urls)), 
url(r'^accounts/', include(accounts urls)), 
url(r'^api/', include(api urls)), 


FH: 


lists/api urls.py 
from django.conf.urls import url 
from lists import api 


urlpatterns - [ 
url(r'^lists/(MAd*)/$', api.list, name-'api list'), 
] 


API 的 核心 代码 可 以 放 在 api. py 文件 中 ， 只 需 三 行 代 码 就 行 了 : 


lists/api.py 
from django.http import HttpResponse 


def list(request, list id): 
return HttpResponse(content type-'application/json') 


测试 应 该 能 通过 。 现 在 就 有 了 基础 结构 。 


$ python manage.py test lists 


I 2s] 





Ran 50 tests in 0.177s 


OK 


F.4 返回 实质 内 容 


接 下 来 ， 我 们 要 让 API 返回 一 些 实质 内 容 ， 即 清单 中 各 待 办 事项 的 JSON 表示 形式 : 








lists/tests/test api.py (ch361002) 


def test get returns items for correct list(self): 
other list - List.objects.create() 
Item.objects.create(list-other list, text-'item 1') 
our list - List.objects.create() 
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o 


item1 = Item.objects.create(list-our list, text-'item 1') 
item2 - Item.objects.create(list-our list, text-'item 2') 
response - self.client.get(self.base url.format(our list.id)) 
self.assertEqual( 
json.loads(response.content.decode('utf8')), © 
[ 
['id': itemi.id, 'text': itemi.text], 
{'id': item2.id, 'text': item2.text], 


) 
个 测试 主要 要 注意 这 一 点 。 我 们 期 望 响应 是 JSON 格式 ， 使 用 3son. loads) 是 因为 

















Python 对 象 比 直 接 处 理 原始 的 JSON 字符 串 容 易 。 
实现 时 则 要 反 过 来 ， 使 用 json.dumps() : 











lists/api.py 


import json 
from django.http import HttpResponse 
from lists.models import List, Item 


def 


list(request, list id): 
list = List.objects.get(id-list id) 
item dicts = [ 
('id': item.id, 'text': item.text) 
for item in list .item set.all() 
] 
return HttpResponse( 
json.dumps(item dicts), 
content type-'application/json' 


) 


这 是 使 用 列表 推导 的 好 机 会 ! 


F.5 


ie iod 青 求 的 支持 





这 个 API 还 要 允许 通过 POST 请 求 向 清单 中 添加 新 待 办 事项 。 先 采用 常规 方式 .: 


实现 同 检 
定向 : 




















lists/tests/test api.py (ch361004) 


def test POSTing a new item(self): 

list = List.objects.create() 

response = self.client.post( 
self.base url.format(list .id), 
('text': 'new item'}, 

) 

self.assertEqual(response.status code, 201) 

new item - list .item set.get() 

self.assertEqual(new item.text, 'new item') 


简单 ， 基 本 上 与 常规 的 视图 所 做 的 一 样 ， 不 过 这 里 要 返回 201 响应 ， 而 不 能 重 


He 
LH 
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lists/api.py (ch361005) 


def list(request, list id): 
list = List.objects.get(id-list id) 
if request.method -- 'POST': 
Item.objects.create(list-list , text-request.POST['text']) 
return HttpResponse(status-201) 
item dicts - [ 


Ei] 
这 样 便 可 以 了 : 


$ python manage.py test lists 
[...] 





Ran 52 tests in 0.177s 


OK 


构建 REST API 的 要 点 之 一 是 ， 要 充分 利用 HTTP 状态 码 。 





F.6 ”使 用 Sinon.js 测 试 客户 端 Ajax 

没有 模拟 库 是 无 法 测试 Ajax 的 。 不 同 的 测试 框架 和 工具 采用 不 同 的 模拟 库 ， 而 Sinon 是 
通用 的 。 稍 后 你 将 看 到 ，Sinon 还 提供 了 JavaScript W. 

下 载 Sinon， 将 其 放 到 lists/static/tests/ 文件 夹 中 。 

下 面 编写 第 一 个 Ajax 测试 : 








lists/static/tests/tests.html (ch361007) 


«div id-"qunit-fixture"» 
«form» 
«input name-"text" /> 
«div class-"has-error"-Error text«/div» 


</form> 

<table id="id_list_table"> @ 

</table> 
</div> 
<script srcz"../jquery-3.1.1.min. js"»«/script» 
«script srcz"../list.js"»«/script» 


«script src-"qunit-2.0.1.js"»«/script» 
«script srcz"sinon-1.17.6.js"»«/script» 6 


«script» 
/* global sinon */ 


var server; 
QUnit.testStart(function () { 
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© 


server = sinon.fakeServer.create(); © 


35 
QUnit.testDone(function () f 
server.restore(); © 


F); 


QUnit.test("errors should be hidden on keypress", function (assert) { 


[...] 


QUnit.test("should get items by ajax on initialize", function (assert) { 
var url = '/getitems/'; 
window.Superlists.initialize(url); 


assert.equal(server.requests.length, 1); O 
var request - server.requests[0]; 
assert.equal(request.url, url); 
assert.equal(request.method, 'GET'); 

DE 


</script> 
在 固件 div 元 素 中 添加 一 个 元 素 ， 表 示 清 单 表格 。 
导入 sinon.js (要 先 下 载 ， 并 放 到 正确 的 文件 夹 中 )。 


QUnit 中 的 testStart 和 testDone 对 应 于 Python 测试 中 的 setUp 和 tearDown, 3x Hi, 
我 们 让 Sinon 启动 Ajax 测试 工具 (fakeserver)， 并 将 它 赋值 给 全 局 作用 域 中 的 server 


变 











[= 
EH. o 





然后 通过 server 对 代码 发 送 的 Ajax 请 求 下 断言 。 这 里 ， 我 们 测试 请 求 的 目标 URL 和 
所 用 的 HTTP 方法 。 








为 了 发 送 Ajax 请 求 ， 我 们 将 使 用 jQuery 提供 的 Ajax 辅助 方法 ， 这 比 使 用 浏览 器 底层 的 标 
if XMLHttpRequest 对 象 要 简单 得 多 





lists/static/list.js 


QQ -1,6 +1,10 QQ 
window.Superlists = {}; 
-Wwindow.Superlists.initialize = function () { 
*window.Superlists.initialize = function (url) { 
$('input[name-"text"]').on('keypress', function () { 
$('.has-error').hide(); 


35 
十 
+ S$.get(url); 
A 
J; 
3 


现在 测试 应 该 能 通过 : 


5 assertions of 5 passed, 0 failed. 
1. errors should be hidden on keypress (1) 
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2. errors aren't hidden if there is no keypress (1) 
3. should get items by ajax on initialize (3) 


好 吧 ， 我 们 能 向 服务 器 发 送 GET 请 求 了 ， 但 是 具体 的 操作 呢 ? 我 们 应 该 如 何 测试 “异步 ” 
请 求 ， 应 该 如 何 处 理 (最 终 得 到 的 ) 响应 呢 ? 


使 用 Sinon 测 试 Ajax 请 求 的 异步 行为 
这 是 人 们 喜欢 Sinon 的 主要 原因 。 我 们 可 以 通过 server.respond() 准确 控制 异步 代码 的 流程 : 





lists/static/tests/tests.html (ch361009) 


QUnit.test("should fill in lists table from ajax response", function (assert) { 
var url = '/getitems/'; 
var responseData - [ 
('id': 101, 'text': 'item 1 text'), 
('id': 102, 'text': 'item 2 text'}, 
J; 
server.respondWith('GET', url, [ 
200, ("Content-Type": "application/json"), JSON.stringify(responseData) © 
1; 


window.Superlists.initialize(url); 6 
server.respond(); © 


var rows = $('#id list table tr'); © 
assert.equal(rows.length, 2); 

var row1 = $('#id list table tr:first-child td'); 
assert.equal(rowi.text(), '1: item 1 text'); 

var row2 = $('#id list table tr:last-child td'); 
assert.equal(row2.text(), '2: item 2 text'); 


















































5 
O 设 定 一些 响 应 数据 供 Sinon 使 用 。 我 们 设 定 了 状态 码 、 首 部 以 及 希望 服务 器 返回 的 
JSON 响应 一 一 这 是 最 重要 的 。 
e ”然后 调用 要 测试 的 函数 。 
e ”关键 时 刻 到 了 。 随 后 ， 我 们 可 以 在 任何 需要 的 地 方 调用 server.respond()， 触 发 Ajax 
循环 中 所 有 的 异步 代码 ， 即 用 于 处 理 响 应 的 那些 回调 。 
O ”然后 检查 Ajax 回调 有 没有 在 表格 的 行 中 填充 新 的 待 办 事项 。 
实现 如 下 所 示 : 
lists/static/list.js (ch361010) 
if (url) ( 
$.get(url).done(function (response) { 
var rows = ''; 
for (var i20; i«response.length; i++) { 
var item = response[i]; 
rows += '\n<tr><td>' + (i41) + ': ' + item.text + '«/td»«/tr»'; 
} 
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$('stid list table').html(rows); 
H; 
} 








我 们 很 幸运 ， 因 为 jQuery 是 使 用 .done() 函数 为 Ajax 注册 回调 的 。 如 果 使 
用 标准 的 JavaScript Promise .then() 回调 ， 异 步 操作 就 要 多 一 层 。 不 过 ， 
QUnit 也 能 处 理 ， 详 情 参见 async 函数 的 文档 。 其 他 测试 框架 为 此 也 提供 了 
类 似 的 函数 。 


F.7 ”在 模板 中 连接 各 部 分 ， 确 认 这 样 是 否 真 的 可 行 


我 们 先 做 个 破坏 ， 把 lists.html 模板 中 用 于 显示 清单 表格 的 {% for *) 循环 删 掉 : 























lists/templates/list.html 
QQ -6,9 *6,6 QQ 


{% block table %} 
«table id-"id list table" class-"table"» 
(X for item in list.item set.all X) 


<tr><td>{{ forloop.counter jJ): {{ item.text )j«/td»«/tr» 
{% endfor X) 
</table> 


{% if list.owner %} 











这 会 导致 其 中 一 个 单元 测试 失败 ， 可 以 先 暂时 删除 那个 测试 。 











优雅 降级 和 渐进 增强 
删除 非 Ajax 版 本 的 清单 页 面 之 后 ， 就 无 法 优雅 降级 了 ， 即 没有 在 禁用 JavaScript 的 情 
况 下 依然 能 正常 使 用 的 版 本 。 
以 前 ， 优 雅 降级 通常 是 为 了 提供 辅助 功能 ， 因 为 供 视 觉 障 碍 人 士 使 用 的 “屏幕 阅读 器 ” 通 
常 不 支持 JavaScript， 所 以 完全 依赖 JavaScript 就 把 这 部 分 用 户 排 除 在 外 了 。 但 据 我 了 解 ， 
现在 这 已 经 不 是 什么 大 问题 了 。 但 有 些 用 户 甚 至 会 基于 安全 方面 的 原因 而 禁用 JavaScript, 
另 一 个 常见 的 问题 是 ， 为 不 同 的 浏览 器 提供 不 同 程度 的 JavaScript 支持 。 当 你 开始 迈 
向 “现代 的 ”前 端 开 发 和 ES2015 时 ， 尤 其 要 注意 这 个 问题 。 
简单 来 说 ， 最 好 始终 提供 非 JavaScript 版 本 的 “后 援 "“。 如 果 已 经 先 构建 好 了 无 须 


JavaScript 就 能 正常 使 用 的 网 站 ， 就 二 万 不 要 轻易 把 “陈旧 的 ”HTML 版 本 删除 。 我 这 
么 做 只 是 因为 删除 后 更 便于 说 明 我 想 讲 的 内 容 。 
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FAS Sr COD REO TAG AU 


$ python manage.py test functional tests.test simple list creation 


A 





beei] 
FAIL: test_can_start_a_list_for_one_user 
[sis] 


File "/.../superlists/functional tests/test simple list creation.py", line 
32, in test can start a list for one user 
self.wait for row in list table('1: Buy peacock feathers') 


La] 
AssertionError: '1: Buy peacock feathers' not found in [] 
[ee] 


FAIL: test_multiple_users_can_start_lists_at_different_urls 
FAILED (failures=2) 


下 面 在 基 模 板 中 添加 一 个 { scripts %} We, PEIE CAEN E A FEE mi : 























lists/templates/base.html 


«script srcz"/static/list.js"»«/script» 


{% block scripts %} 
«script» 
$(document).ready(function () f 
window.Superlists.initialize(); 


IDE 
«[script» 
{% endblock scripts 9) 
</body> 
然后 ， 在 listhtml 中 稍微 修改 一 下 调用 initialize 的 方式 ， 传 和 正确 的 URL: 


lists/templates/list.html (ch361016) 














(* block scripts %} 
«script» 
$(document).ready(function () f 
var url = "(* url 'api list' list.id %}"; 
window.Superlists.initialize(url); 
35 
</script> 
{% endblock scripts %} 


你 猪 怎么 着 ?测试 通过 了 | 


$ python manage.py test functional tests.test simple list creation 


[Sea 
Ran 2 test in 11.730s 





OK 
这 是 个 不 错 的 开始 ! 
如 果 这 时 运行 功能 测试 ， 你 会 发 现 其 他 功能 测试 中 有 几 个 失败 。 接 下 来 我 们 就 要 处 理 这 























I 
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失败 。 此 外 ， 这 里 还 在 使 用 通过 表单 处 理 POST 请 求 的 过 时 方法 ， 页 面 需要 刷新 ， 离 时 下 
流行 的 单 页 应 用 还 有 段 距离 。 但 我 们 正 向 着 目标 前 进 ! 


F.8 实现 Ajax POST， 包 括 CSRF 令 牌 


首先 为 清单 表格 设 定 一 个 id， 以便 在 JavaScript 代码 中 引用 它 : 


























lists/templates/base.html 


<h1>{% block header text %}{% endblock %}</hi> 
{% block list form X) 
«form id-"id item form" method="POST" action="{% block form action %}{% endblock %}"> 
{{ form.text }} 


[s] 
然后 使 用 ID 调整 JavaScript 测试 中 的 固件 ， 并 加 上 页 面 当 前 的 CSRF 令 牌 : 





lists/static/tests/tests.html 


@@ -9,9 +9,14 @@ 
<body> 
«div id="qunit"></div> 
<div id="qunit-fixture"> 
- <form> 
+ «form id="id item form"> 
<input name="text" /> 
<div class="has-error">Error text</div> 


+ «input type="hidden" name="csrfmiddlewaretoken" value="tokey" /> 
+ «div class-"has-error"» 
十 «div class-"help-block"» 
* Error text 
+ </div> 
+ </div> 
</form> 
测试 如 下 : 


lists/static/tests/tests.html (ch361019) 


QUnit.test("should intercept form submit and do ajax post", function (assert) { 
var url = '/listitemsapi/'; 
window.Superlists.initialize(url); 


$('#id item form input[name-"text"]').val('user input'); ©@ 
$('#id item form input[name-"csrfmiddlewaretoken"]').val('tokeney'); © 
S$('stid item form').submit(); © 


assert.equal(server.requests.length, 2); 6 
var request - server.requests[1]; 
assert.equal(request.url, url); 
assert.equal(request.method, "POST"); 
assert.equal( 
request.requestBody, 
'text-userrinput&csrfmiddlewaretoken-tokeney' © 
); 
35 
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@ ”模拟 用 户 操 作 ， 填 表 后 点 击 提交 按钮 。 

e ELM NIE E ALANI ERE 

© ”检查 POST 请 求 的 requestBody。 可 以 看 出 ， 它 的 值 经 过 URL 编码 了 ， 这 虽然 不 是 最 
易于 测试 的 ， 但 是 可 读 性 尚 可 。 

实现 方式 如 下 : 


lists/static/list.js 


[5:527] 
$('#id list table').html(rows); 
9; 


var form = $('#id item form'); 
form.on('submit', function(event) { 
event.preventDefault(); 
$.post(url, { 
'text': form.find('input[name="text"]').val(), 
'csrfmiddlewaretoken': form.find('input[name="csrfmiddlewaretoken"]').val(), 
}); 
95 


现在 JavaScript 测试 能 通过 了 ， 但 是 功能 测试 却 失 败 了 ， 因 为 虽然 POST 请 求 成 功 了 ， 但 
是 却 没 有 更 新 页 面 ， 显 示 新 添加 的 待 办 事项 : 


F. 


$ python manage.py test functional tests.test simple list creation 


[...] 
AssertionError: '2: Use peacock feathers to make a fly' not found in ['1: Buy 
peacock feathers'] 


9 _ JavaScript 中 的 模拟 技术 














我 们 希望 处 理 完 Ajax POST 请 求 后 ， 客 户 端 能 更 新 表格 中 的 待 办 事项 。 其 实 这 与 重新 加 载 
页 面 所 做 的 事情 是 一 样 的 ， 我 们 要 从 服务 器 中 获取 清单 中 当前 的 待 办 事项 ， 然 后 在 表格 中 









































显示 出 来 。 
看 来 ， 我 们 需要 一 个 辅助 函数 。 





lists/static/list.js 


window.Superlists = (); 


window.Superlists.updateItems = function (url) { 
$.get(url).done(function (response) { 
var rows = ''; 
for (var i-0; i«response.length; i++) { 
var item = response[i]; 
rows += '\n<tr><td>' + (i41) + 


+ item.text + '</td></tr>'; 


$('#id_list_table').html(rows); 
}); 
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J; 


window. Super lists.initialize = function (url) { 
$('input[name="text"]').on('keypress', function () { 

$('.has-error').hide(); 

IDE 


if (url) { 
window.Superlists.updateItems(url); 


var form = $('#id item form'); 


[...] 
这 只 算是 一 次 重 构 。 经 确认 ， 现 在 JavaScript 测试 依然 能 通过 : 


12 assertions of 12 passed, 0 failed. 

errors should be hidden on keypress (1) 

errors aren't hidden if there is no keypress (1) 
should get items by ajax on initialize (3) 

should fill in lists table from ajax response (3) 
should intercept form submit and do ajax post (4) 


Un» UunP€ H 


那么 ， 我 们 应 该 如 何 测试 Ajax POST 请 求 成 功 后 调用 了 updateItems WE? dX 8T 88 
傻 地 重复 编写 模拟 服务 器 响应 的 代码 ， 然 后 自己 动手 检查 待 办 事项 表格 …… 要 不 使 用 驭 
件 试 试 ? 
首先 ， 设置 一 个 “ 沙 盒 ”， 让 它 跟踪 我 们 创建 的 所 有 驭 件 ， 并 在 每 次 测试 之 后 把 被 模拟 的 





lists/static/tests/tests.html (ch361023) 


var server, sandbox; 
QUnit.testStart(function () { 
server = sinon.fakeServer.create(); 
sandbox = sinon.sandbox.create(); 
35 
QUnit.testDone(function () f 
server.restore(); 
sandbox.restore(); © 


IDE 
@ .restore() 是 重点 ， 它 的 作用 是 在 每 次 测试 之 后 还 原 被 模拟 的 东西 。 


lists/static/tests/tests.html (ch361024) 


QUnit.test("should call updateItems after successful post", function (assert) { 
var url = '/listitemsapi/'; 
window.Superlists.initialize(url); © 
var response = [ 
201, 
("Content-Type": "application/json"], 
JSON.stringify([)), 
]; 
server.respondWith('POST', url, response); © 
S$('stid item form input[name-"text"]').val('user input'); 
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$('#id item form input[name-"csrfmiddlewaretoken"]').val('tokeney'); 
$('#id item form').submit(); 


sandbox.spy(window.Superlists, 'updateItems'); 6 
server.respond(); 6 


assert.equal( 
window.Superlists.updateltems.lastCall.args, © 
url 


@ 首先 要 注意 ， 初 始 化 之 后 才能 设置 服务 器 响应 。 这 是 因为 我 们 想 设 置 的 是 提交 表单 时 
发 送 的 POST 请 求 的 响应 ， 而 不 是 一 开始 那个 GET 请 求 的 响应 。( 还 记得 第 16 章 所 学 
的 知识 吗 ? JavaScript 测试 最 难 掌握 的 技术 之 一 便 是 控制 执行 顺序 。) 

@ 同样 ， 仅 当 开 始 那个 GET 请 求 处 理 完毕 之 后 ， 我 们 才 开 始 模拟 辅助 函数 。sandbox.spy 
调用 的 作用 与 Python 测试 中 的 patch 一 样 ， 把 指定 对 象 替 换 为 驭 件 。 

e ”模拟 的 updateItems 国 数 现 在 多 了 一 些 属 性 ， 例 如 lastCall 和 lastCall.args (类 似 
于 Python 驭 件 的 catt args), 


让 测试 通过 之 前 ， 我 们 想 故 意 犯 个 错 ， 确 认 它 的 确 能 测试 我 们 想 测试 的 行为 : 












































lists/static/list.js 


$.post(url, ( 

'text': form.find('input[name-"text"]').val(), 

'csrfmiddlewaretoken': form.find('input[name-"csrfmiddlewaretoken"]').val(), 
J).done(function () { 

window.Superlists.updateItems(); 


FA; 
收效 不 错 ， 但 功能 测试 还 未 全 部 通过 : 


12 assertions of 13 passed, 1 failed. 


|W | 
6. should call updateItems after successful post (1, 0, 1) 
1. failed 
Expected: "/listitemsapi/" 
Result: [] 
Diff: "/listitemsapi/"[] 
Source: file:///.../superlists/lists/static/tests/tests.html:124:15 
据 此 修正 : 


lists/static/list.js 


J).done(function () { 
window.Superlists.updateItems(url); 


F) 
现在 功能 测试 通过 了 ! 或 者 ， 至 少 部 分 通过 了 。 其 他 测试 还 有 问题 ， 稍 后 再 回来 解决 。 
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结束 重 构 : 让 测试 与 代码 匹配 


现在 ,我 有 点 不 舒心 ， 因 为 重 构 还 没 结束 。 下 面 稍微 让 单元 测试 与 代码 匹配 一 些 : 























lists/static/tests/tests.html 


@@ -50,9 +50,19 @@ QUnit.testDone(function () { 
); 


-QUnit.test("should get items by ajax on initialize", function (assert) { 

*QUnit.test("should call updateItems on initialize", function (assert) { 
var url = '/getitems/'; 

+ sandbox.spy(window.Superlists, 'updateItems'); 
window.Superlists.initialize(url); 


* assert.equal( 

十 window.Superlists.updateItems.lastCall.args, 

十 url 

* ) 

+}); 

p 

4*QUnit.test("updateItems should get correct url by ajax", function (assert) { 
+ var url = '/getitems/'; 


+ window.Superlists.updateItems(url); 


assert.equal(server.requests.length, 1); 
var request - server.requests[0]; 
@@ -60,7 470,7 @@ QUnit.test("should get items by ajax on initialize", function (assert) { 
assert.equal(request.method, 'GET'); 
35 


-QUnit.test("should fill in lists table from ajax response", function (assert) { 
4QUnit.test("updateItems should fill in lists table from ajax response", function (assert) { 
var url = '/getitems/'; 
var responseData - [ 
['id': 101, 'text': 'item 1 text'), 
@@ -69,7 +79,7 @@ QUnit.test("should fill in lists table from ajax response", function [...] 
server.respondWith('GET', url, [ 
200, ("Content-Type": "application/json"), JSON.stringify(responseData) 
D; 
- window.Superlists.initialize(url); 
+ window.Superlists.updateItems(url); 


server.respond(); 
现在 测试 的 结果 如 下 : 


14 assertions of 14 passed, 0 failed. 

errors should be hidden on keypress (1) 

errors aren't hidden if there is no keypress (1) 

should call updateItems on initialize (1) 

updatelItems should get correct url by ajax (3) 

updateItems should fill in lists table from ajax response (3) 
should intercept form submit and do ajax post (4) 

should call updateItems after successful post (1) 








~ 上 WwWDP 请 
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F0 数据 验证 : 留 给 读者 的 练习 
如 果 运 行 全 部 测试 ， 你 会 发 现 有 两 个 针对 验证 的 功能 测试 失败 了 : 


$ python manage.py test 

[1 

ERROR: test cannot add duplicate items 

(functional tests.test list item validation.ItemValidationTest) 

[...] 

ERROR: test error messages are cleared on input 

(functional tests.test list item validation.ItemValidationTest) 

REA 

selenium.common.exceptions.NoSuchElementException: Message: Unable to locate 
element: .has-error 


我 不 会 告诉 你 具体 应 该 怎么 解决 ， 下 面 仅 给 出 所 需 的 单元 测试 





lists/tests/test api.py (ch361027) 


from lists.forms import DUPLICATE ITEM ERROR, EMPTY ITEM ERROR 
[...] 
def post empty input(self): 
list = List.objects.create() 
return self.client.post( 
self.base url.format(list .id), 
data-(['text': '') 


def test for invalid input nothing saved to db(self): 
self.post empty input() 
self.assertEqual(Item.objects.count(), 0) 


def test for invalid input returns error code(self): 
response - self.post empty input() 
self.assertEqual(response.status code, 400) 
self.assertEqual( 
json.loads(response.content.decode('utf8')), 
('error': EMPTY ITEM ERROR) 


def test duplicate items error(self): 
list = List.objects.create() 
self.client.post( 
self.base url.format(list .id), data-(['text': 'thing') 
) 
response - self.client.post( 
self.base url.format(list .id), data-(['text': 'thing') 
) 
self.assertEqual(response.status code, 400) 
self.assertEqual( 
json.loads(response.content.decode('utf8')), 
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('error': DUPLICATE ITEM ERROR) 
) 


以 及 JavaScript 测试 : 


lists/static/tests/tests.html (ch361029-2) 


QUnit.test("should display errors on post failure", function (assert) { 
var url = '/listitemsapi/'; 
window.Superlists.initialize(url); 
server.respondWith('POST', url, [ 


400, 

["Content-Type": "application/json"), 

JSON.stringify(['error': 'something is amiss')) 
D; 


$('.has-error').hide(); 


$('#id item form').submit(); 
server.respond(); // post 


assert.equal($('.has-error').is(':visible'), true); 
assert.equal($('.has-error .help-block').text(), 'something is amiss'); 


F); 


QUnit.test("should hide errors on post success", function (assert) { 


[22] 


此 外 ， 你 还 要 修改 base.html 模板 ， 让 它 既 能 显示 Django 错误 (主页 现在 就 能 显示 )， 也 能 
显示 JavaScript 错误 : 


lists/templates/base.html (ch36103 1) 


QQ -51,17 451,21 QQ 
«div class-"col-md-6 col-md-offset-3 jumbotron"» 
«div class-"text-center"» 
<h1>{% block header text %}{% endblock %}</h1> 


{% block list form X) 
«form id-"id item form" method="POST" action="{% block [...] 
{{ form.text }} 
{% csrf_token %} 
- {% if form.errors %} 
- <div class="form-group has-error"> 
- «div class="help-block">{{ form.text.errors }}</div> 
+ <div class="form-group has-error"> 
+ <div class="help-block"> 
+ {% if form.errors %} 
+ {{ form.text.errors }} 
+ {% endif %} 
</div> 
- {% endif %} 
+ </div> 
</form> 
{% endblock %} 
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最 终 


A 


</div> 
</div> 
</div> 


» 3517 JavaScript 测试 应 该 得 到 类 似 下 面 的 结果 : 


20 assertions of 20 passed, 0 failed. 

. errors should be hidden on keypress (1) 

. errors aren't hidden if there is no keypress (1) 

should call updateItems on initialize (1) 

updateItems should get correct url by ajax (3) 

updateItems should fill in lists table from ajax response (3) 
. Should intercept form submit and do ajax post (4) 

. Should call updateItems after successful post (1) 

. Should not intercept form submit if no api url passed in (1) 
9. should display errors on post failure (2) 

10. should hide errors on post success (1) 

11. should display generic error if no error json (2) 














co ~ 上 wmP FS 


全 部 测试 应 该 都 能 通过 ， 包 括 所 有 功能 测试 : 


$ python manage.py test 
[522] 

Ran 81 tests in 62.029s 
OK 


太 棒 了 ! T 

这 就 是 我 们 自己 动手 使 用 Django 构建 的 REST API。 如 果 需 要 提示 ， 可 以 查看 代码 示例 仓 
库 中 的 代码 (https://github.com/hjwp/book-example/tree/appendix_rest_api) 。 

不 过 ， 我 不 建议 使 用 Django 自己 动手 构建 REST API， 在 此 之 前 ， 你 至 少 应 该 考察 一 下 
Django-Rest-Framework， 详 情 参 见 附 录 G。 继 续 前 行 吧 ! 


























REST API 小 贴 士 


不 要 重复 编写 URL 

与 面向 浏览 器 的 应 用 相 比 ，API 的 URL 更 为 重要 。 尽 量 减 少 在 测试 中 硬 编码 
URL 的 次 数 。 

不 要 直接 处 理 原始 JSON 字符 串 

让 json.loads 和 json.dumps 常 伴 你 左右 。 








JavaScript 测试 应 该 使 用 Ajax 模拟 库 

Sinon 不 错 。Jasmine 自 带 了 ，Angular 也 是 。 

牢记 优雅 降级 和 渐进 增强 

尤其 是 把 静态 网 站 变 成 由 JavaScript 驱动 的 网 站 时 ， 至 少 要 让 网 站 的 核心 功能 在 没 
有 JavaScript 时 依然 能 使 用 。 
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附录 G 
Django-Rest-Framework 





在 附录 下 中， 我 们 自己 动手 构建 了 一 个 REST API WE, KAA Django-Rest-Framework, 
这 是 很 多 Python/Django 开发 者 构建 API 时 的 首选 工具 。Django 的 目的 是 为 构建 数据 库 驱 
动 的 网 站 提供 各 种 基础 工具 (ORM、 模 板 等 )， 而 Django-Rest-Framework 的 目的 则 是 为 构 
建 API 提供 全 部 工具 ， 从 而 避免 一 次 次 地 编写 样板 代码 。 

撰写 本 附录 时 ， 我 苦 苗 思索 ， 怎 样 使 用 Django-Rest-Framework 构建 一 个 与 前 面 自己 动手 
实现 的 那个 一 模 一 样 的 API 呢 ?车 想 在 Django-Rest-Framework 中 得 到 同样 的 URL 结构 
和 JSON 数据 结构 ， 面 临 巨大 的 挑战 。 在 实现 的 过 程 中 ， 我 感觉 自己 是 在 与 Django-Rest- 
Framework 做 斗争 。 


这 提醒 了 我 ， 让 我 陷 人 和 人 沉思。 构建 Django-Rest-Framework 的 人 比 我 聪明 得 多 ， 他 们 见 过 
的 REST API 也 比 我 多 得 多 。 如 果 他 们 觉得 应 该 以 某 种 方式 处 理 ， 或 许 就 表明 我 应 该 采用 
那 种 方式 。 我 应 该 站 在 他 们 的 角度 思 孝 问题 ， 而 不 应 该 固执 己见 。 


“ 别 与 框架 做 斗争 *"， 这 是 我 听 过 的 至 理 名 言 之 一 。 如 果 不 能 顺应 框架 ， 可 能 就 要 想 想 自 己 
到 底 需 不 需要 使 用 框架 。 


我 们 将 以 附录 下 构建 的 API 为 监 本 ， 尝 试 使 用 Django-Rest-Framework 重 写 。 
r3 Jt 
G.1 AE 


Django-Rest-Framework 使 用 pip install 命令 就 能 安装 。 我 使 用 的 是 创作 本 书 时 的 最 新 版 一 一 
3.5.4 版: 



























































$ pip install djangorestframework 
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然后 把 rest framework 添 


INSTALLED APPS = [ 


加 到 settings.py 中 的 INSTALLED APPS 设置 中 : 


superlists/settings.py 


i&'django.contrib.admin', 


'django.contrib. 
'django.contrib. 
'django.contrib. 
'django.contrib. 
'django.contrib. 
'lists', 
'accounts', 


auth', 
contenttypes', 
sessions', 
messages', 
staticfiles', 


'functional tests', 


'rest framework' 


] 


G.2 RER 


Django-Rest-Framework 





5 


(具体 而 言 是 ModelSerializer) 





网 的 教程 是 学 习 这 个 框架 的 好 资源 。 一 开始 你 就 会 遇 到 串 化 








器 (serializer) ， 这 里 具体 而 言 是 Modelserializer, Django-Rest-Framework 通过 串 化 器 把 
Django 数据 库 模 型 转换 为 交换 数据 所 需 的 JSON (或 其 他 格式 )。 














lists/api.py (ch371003) 


from lists.models import List, Item 


ies] 


from rest_framework import routers, serializers, viewsets 


class ItemSerializer(serializers.ModelSerializer): 


class Meta: 
model = Item 


fields = ('id', 'text') 


class ListSerializer(serializers.ModelSerializer): 
items = ItemSerializer(many=True, source='item_set') 


class Meta: 
model = List 


fields = ('id', 'items',) 


G.3 Viewset 


Django-Rest-Framework 使 


(具体 而 言 是 ModelViewset) 和 路 由 器 


用 Modelviewset 定义 通过 API 与 某 个 模型 对 象 的 交互 方式 。 


我 们 只 需 指明 想 操 作 的 是 哪个 模型 (通过 queryset 属性 )， 以 及 如 何 序列 化 模型 对 象 
(serializer_class)， 余 下 的 工作 由 ModelviewSet 自动 完成 ， 即 自动 构建 相关 视图 ， 供 列 
出 、 歼 取 、 更 新 ， 甚 至 是 删除 对 象 。 
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为 了 从 特定 的 清单 中 获取 待 办 事项 ， 只 需 定义 这 样 一 个 ViewSet: 


lists/api.py (ch371004) 


class ListViewSet(viewsets.ModelViewSet): 
queryset - List.objects.all() 
serializer class = ListSerializer 


router - routers.SimpleRouter() 
router.register(r'lists', ListViewSet) 


Django-Rest-Framework 通过 路 由 器 自动 构建 URL 配置 ， 并 把 它们 映射 到 ViewSet 提供 的 
功能 

现在 ， 我 们 可 以 修改 urls.py， 绕 开 旧 的 API 代码 ， 指 向 新 的 路 由 器 ， 看 看 测试 的 情况 
如 何 : 


superlists/urls.py (ch371005) 
[...] 


# from lists.api import urls as api urls 
from lists.api import router 


urlpatterns - [ 
url(r'^$', list views.home page, name-'home'), 
url(r'^lists/', include(list urls)), 
url(r'^accounts/', include(accounts urls)), 
4 url(r'^api/', include(api urls)), 
url(r'^api/', include(router.urls)), 





] 

结果 好 多 测试 都 失败 了 : 
$ python manage.py test lists 
[I] 


django.urls.exceptions.NoReverseMatch: Reverse for 'api list' not found. 
'api list' is not a valid view function or pattern name. 

[5:535] 
AssertionError: 405 !- 400 
[oss] 
AssertionError: {'id': 2, 'items': [{'id': 2, 'text': 'item 1'}, {'id': 3, 
'text': 'item 2'}]} != [('id': 2, 'text': 'item 1'}, ('id': 3, 'text': 'item 
2')] 





Ran 54 tests in 0.243s 

FAILED (failures-4, errors-10) 
先 看 那 10 个 错误 ， 报 错 消息 都 说 无 法 反 转 api list, 3X5 A79 Django-Rest-Framework 路 
由 器 使 用 的 命名 约定 与 前 面 我 们 自己 制定 的 不 同 。 从 调用 跟踪 可 以 看 出 ， 这 些 错误 发 生 


在 泻 染 模板 上 时。 具体 而 言 ， 是 list.html 模板 。 我 们 只 需 修改 一 处 就 能 修正 这 些 错误 一 一 把 
api list 改 成 List-detail: 
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lists/templates/list.html (ch371006) 


«script» 
$(document).ready(function () f 

var url = "(* url 'list-detail' list.id X)"; 
DE 


</script> 


样 修改 之 后 ， 只 剩 下 4 个 失败 了 : 


$ python manage.py test lists 





ox 


FAIL: test POSTing a new item (lists.tests.test api.ListAPITest) 


[2:1 
FAIL: test duplicate items error (lists.tests.test api.ListAPITest) 
[...] 


FAIL: test for invalid input returns error code 
(lists.tests.test api.ListAPITest) 

[5:24 

FAIL: test get returns items for correct list 
(lists.tests.test api.ListAPITest) 

ERSS 

FAILED (failures=4) 


暂且 关闭 所 有 验证 测试 ， 后 面 再 想 办 法 解决 : 

















lists/tests/test api.py (ch371007) 


A DONTtest for invalid input nothing saved to db(self): 
def Leu Mec E A E N 
def TU E TD 
Dos] 
现在 只 有 2 个 失败 了 : 
FAIL: test POSTing a new item (lists.tests.test api.ListAPITest) 
[se 


self.assertEqual(response.status code, 201) 
AssertionError: 405 !- 201 
[zs] 
FAIL: test get returns items for correct list 
(lists.tests.test api.ListAPITest) 


Io] 


AssertionError: { id': 2, 'items': [{'id': 2, 'text': 'item 1'), ['id': 3, 


'text': 'item 2'}]} != [('id': 2, 'text': 'item 1'), ('id': 3, 'text': 'item 


223: 
[252] 
FAILED (failures-2) 


先 看 最 后 1 个 失败 。 


Django-Rest-Framework 的 默认 配置 得 到 的 数据 结构 与 我 们 自己 动手 构建 时 稍 有 不 同 ，GET 











请 求 清单 得 到 的 响应 中 有 清单 的 ID ， 而 且 清 单 中 的 竺 办 事项 在 items 键 名 下 。 因 





此 ， 为 了 
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让 测试 通过 ， 我 们 要 稍微 修改 一 下 单元 测试 : 





lists/tests/test api.py (ch371008) 


QQ -23,10 «23,10 QQ class ListAPITest(TestCase): 
response - self.client.get(self.base url.format(our list.id)) 
self.assertEqual( 
json.loads(response.content.decode('utf8')), 


[ 
* ['id': our list.id, 'items': [ 
['id': itemi.id, 'text': itemi.text), 
('id': item2.id, 'text': item2.text], 
- ] 
* 1 


) 


a a ee 事项 了 ( 稍 后 将 看 到 ， 随 之 一 起 返回 的 还 有 很 多 
其 他 数据 )， 那 通过 POST 请 求 添加 新 待 办 事项 呢 ? 


G.4 通过 POST 请 求 添加 待 办 事项 的 URL 

这 次 我 不 再 与 框架 做 斗争 了 ， 而 是 顺应 Django-Rest-Framework。 问 清单 的 ViewSet 发 送 

POST 请 求 是 可 以 添加 待 办 事项 ， 但 极为 麻烦 。 
最 简单 的 方法 是 向 待 办 事项 的 ViewSet 发 送 POST 请 求 ， 而 不 是 清单 的 ViewSet: 


lists/api.py (ch371009) 









































class ItemViewSet(viewsets.ModelViewSet): 
serializer class - ItemSerializer 
queryset - Item.objects.all() 


[25] 


router.register(r'items', ItemViewSet) 


意味 着 我 们 要 稍微 修改 测试 ， 把 POST 测试 从 ListAPITest 中 移出 来 ， 放 到 新 的 测试 类 


ItemsAPITest 中 : 


lists/tests/test api.py (ch371010) 


QQ -1,3 +1,4 QQ 
import json 
*from django.core.urlresolvers import reverse 
from django.test import TestCase 
from lists.models import List, Item 
QQ -31,9 432,13 QQ class ListAPITest(TestCase): 


4 
*class ItemsAPITest(TestCase): 

十 base url = reverse('item-list') 
4 


def test POSTing a new item(self): 
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list = List.objects.create() 
response - self.client.post( 
- self.base url.format(list .id), 











['text': 'new item'), 
* self.base url, 
* ['list': list .id, 'text': 'new item'j, 
) 
self.assertEqual(response.status code, 201) 
现在 测试 的 结果 为 : 








django.db.utils.IntegrityError: NOT NULL constraint failed: lists item.list id 
序列 化 待 办 事项 时 ， 如 果 没 有 指定 清单 的 ID ， 就 不 能 知道 待 办 事项 属于 哪个 清单 : 


lists/api.py (ch371011) 





class ItemSerializer(serializers.ModelSerializer): 


class Meta: 
model - Item 
fields - ('id', 'list', 'text') 


为 此 ， 还 要 修改 另 一 个 有 点 联系 的 测试 : 


lists/tests/test api.py (ch371012) 


QQ -25,8 425,8 @@ class ListAPITest(TestCase): 
self.assertEqual( 

json.loads(response.content.decode('utf8')), 

['id': our list.id, 'items': 
- ('id': itemi.id, 'text': itemi.text], 

('id': item2.id, 'text': item2.text], 

* ('id': itemi.id, 'list': our list.id, 'text': itemi.text], 
* ('id': item2.id, 'list': our list.id, 'text': item2.text], 


]} 


G.5 调整 客户 端 代码 


现在 ， 这 个 API 不 再 返回 一 个 包含 清单 中 所 有 待 办 事项 的 扁平 数组 ， 而 是 返回 一 个 对 象 ， 
待 办 事项 都 在 它 的 .items 属性 中 。 因 此 ， 我 们 要 稍微 调整 一 下 updateItems 函数 : 


lists/static/list.js (ch371013) 












































@@ -3,8 +3,8 @@ window.Superlists = (); 
window.Superlists.updateItems = function (url) { 
$.get(url).done(function (response) { 
var rows = ''; 
- for (var i20; i«response.length; i++) { 
- var item - response[i]; 
for (var i20; i«response.items.length; i++) f 
var item - response.items[i]; 
rows += '\n<tr><td>' + (i41) + ' 


++ 


+ item.text + '</td></tr>'; 


$('#id_list_table').html(rows); 
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而 且 ， 因 为 获取 清单 和 添加 待 办 事项 的 URL 都 变 了 ， 所 以 我 们 还 要 稍微 调整 一 下 
initialize 国 数 。 我 们 不 再 使 用 多 个 参数 ， 而 是 传人 包含 所 需 配置 的 params 对 象 : 
lists/static/list.js 
QQ -11,23 «11,24 QQ window.Superlists.updateItems = function (url) { 
3 
M 


-window.Superlists.initialize = function (url) { 
*window.Superlists.initialize = function (params) f 
$('input[name-"text"]').on('keypress', function () { 
$('.has-error').hide(); 
IDE 


- if (url) { 

- window.Superlists.updateItems(url); 

+ if (params) { 

+ window.Superlists.updateItems(params.listApiUrl); 


var form = $('stid item form'); 
form.on('submit', function(event) { 
event.preventDefault(); 
$.post(url, { 
$.post(params.itemsApiUrl, { 
+ 'list': params.listId, 
'text': form.find('input[name="text"]').val(), 
'csrfmiddlewaretoken': form.find('input[name="csrfmiddlewaretoken"]').val(), 
}).done(function () { 
$('.has-error').hide(); 
- window.Superlists.updateItems(url); 
* window.Superlists.updateItems(params.listApiUrl); 
}).fail(function (xhr) ( 
$('.has-error').show(); 
if (xhr.responseJSON && xhr.responseJSON.error) { 


据 此 修改 list.html 中 的 代码 : 


ES 


lists/templates/list.html (ch371014) 


$(document).ready(function () f 
window.Superlists.initialize(( 
listApiUrl: "{% url 'list-detail' list.id X)", 
itemsApiUrl: "(9 url 'item-list' X)", 
listId: (( list.id jj, 

35 

IDE 


经 过 一 番 修 改 之 后 ， 基 本 的 功能 测试 又 能 通过 了 ， 


$ python manage.py test functional tests.test simple list creation 


Biad 
Ran 2 tests in 15.635s 





OK 
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为 了 解决 前 面 暂时 忽略 的 错误 ， 还 要 做 一 些 修改 。 如 果 不 知 道 如 何 修改 ， 可 以 参照 本 附录 的 
仓库 (https//github.com/hjwp/book-example/blob/appendix DjangoRestFramework/lists/api. py ) o 


G.6 Django-Rest-FrameworkB*] pc 2 
你 可 能 想 知道 为 什么 要 使 用 这 个 框架 。 


G.6.1 用 配置 代替 代码 
第 一 个 优势 是 ， 以 前 的 过 程式 视图 函数 变 成 了 声明 式 句 法 : 














[RH 





lists/api.py 


def list(request, list id): 
list = List.objects.get(id-list id) 
if request.method -- 'POST': 
form = ExistingListItemForm(for list-list , data-request.POST) 
if form.is valid(): 
form.save() 
return HttpResponse(status-201) 
else: 
return HttpResponse( 
json.dumps(('error': form.errors['text'][0])), 
content type-'application/json', 
status-400 
) 
item dicts - [ 
['id': item.id, 'text': item.text) 
for item in list .item set.all() 
] 
return HttpResponse( 
json.dumps(item dicts), 
content type-'application/json' 


) 
如 果 与 使 用 Django-Rest-Framework 得 到 的 最 终 版 本 相 比 ， 你 会 发 现 ， 我 们 完全 是 在 配置 : 





lists/api.py 


class ItemSerializer(serializers.ModelSerializer): 
text = serializers.CharField( 
allow blank-False, error messages-('blank': EMPTY ITEM ERROR) 


) 


Class Meta: 
model - Item 
fields - ('id', 'list', 'text') 
validators - [ 
UniqueTogetherValidator( 
queryset-Item.objects.all(), 
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fieldsz('list', 'text'), 
message-DUPLICATE ITEM ERROR 


class ListSerializer(serializers.ModelSerializer): 
items = ItemSerializer(many-True, source-'item set') 


class Meta: 
model - List 
fields - ('id', 'items',) 


class ListViewSet(viewsets.ModelViewSet): 
queryset - List.objects.all() 
serializer class = ListSerializer 


class ItemViewSet(viewsets.ModelViewSet): 
serializer class - ItemSerializer 
queryset - Item.objects.all() 


router = routers.SimpleRouter() 
router.register(r'lists', ListViewSet) 
router.register(r'items', ItemViewSet) 


G.6.2 自 带 的 功能 

第 二 个 优势 是 ， 使 用 Django-Rest-Framework 的 ModelSerializer, ViewSet 和 路 由 器 得 到 

的 API 比 我 们 自己 动手 构建 的 API 更 具 扩 展 性 。 

。 现在 ， 清 单 和 待 办 事项 相关 的 所 有 URL 都 自动 支持 全 部 HTTP 方法 ， 包 括 GET, POST, 
PUT, PATCH, DELETE 和 OPTIONS, 

。 而 且 在 http://localhost:8000/api/lists/ 和 http://localhost:8000/api/items 可 以 浏览 自动 生成 
的 API 文档 (你 可 以 自己 试 试 ， 如 图 G-1 所 示 )。 

除 此 之 外 ，Django-Rest-Framework 还 有 很 多 优势 ， 详 情 参见 文档 (http://www.django-rest- 

framework.org/topics/documenting-your-api/#self-describing-apis)。 不 过 这 两 个 功能 对 API 的 

用 户 而 言 是 十 分 重要 的 。 

综 上 ，Django-Rest-Framework 是 构建 API 的 优秀 工具 ， 几 乎 能 根据 现 有 的 模型 结构 自动 生 

成 API。 如 果 你 使 用 Django， 在 自己 动手 实现 API 之 前 绝对 应 该 先 考 察 一 下 Django-Rest- 


Framework。 
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Item List - Django REST framework - Mozilla Firefox x 





J Item List - Django REST f... x ula 














(€) 9 localhost:8000/api/items/ vje |Q Search | OOo» = 
Item 


Item List E 


GET /api/items/ 


HTTP 200 OK 

Allow: GET, POST, OPTIONS 
Content-Type: application/json 
Vary: Accept 


[ 
1 
Rs y. 
ER 
"text": "buy milk" 


"id": 2, 
UA S AE 
"text": "write book appendix" 
} 
Raw data HTML form 
List List object J 
Text 


POST 

















G-1: 自动 为 API 用 户 生成 的 文档 
Django-Rest-Framework 小 贴 士 
。 别 与 框架 做 斗争 
若 想 提 高 效率 ， 通 常 最 好 顺应 框架 的 约定 ， 否 则 就 不 要 使 用 框架 ， 或 者 在 较 低 的 层 
级 定制 。 
。 根据 最 小 惊讶 原则 ， 使 用 路 由 器 和 ViewSet 
Django-Rest-Framework 的 优 执 之 一 是 ， 使 用 它 提供 的 工具 (如 路 由 器 和 ViewSet) 
得 到 的 API 是 可 预料 的 ， 端 点 、URL 结构 和 不 同 HTTP 方法 的 响应 都 有 合理 的 上 默 
认 配 置 。 
。 查看 可 浏览 的 API 文档 
在 浏览 器 中 访问 API 的 端点 。Django-Rest-Framework 能 检测 到 你 访问 API 时 使 用 的 
是 “常规 的 ”Web 浏览 器 ， 此 时 它 会 显示 自身 的 精美 文档 ， 可 供 你 分 享 给 你 的 用 户 。 
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速 查 表 


人 们 都 喜欢 速 查 表 ， 所 以 我 根据 每 章 末 尾 旁 广 中 的 总 结 制作 了 这 个 速 查 表 ， 目 的 是 提醒 
你 ， 并 且 链 接 到 具体 章节 ， 以 此 唤起 你 的 记忆 。 和 希望 这 个 速 查 表 有 用 。 


H.1 项 目 开始 阶段 


。 先 构思 一 个 用 户 故事 ， 然 后 转换 成 第 一 个 功能 测试 。 
。 选择 一 个 测试 框架 
。 运行 功能 测试 ， 得 到 第 一 个 预期 失败 。 

。 选择 一 个 Web 框架 ， 例 如 Django， 然 后 弄 清 如 何在 选中 的 
。 针对 目前 失败 的 功能 测试 编写 第 一 个 单元 测试 ， 看 着 它 失 败 
。 做 第 一 次 提交 ， 把 代码 提交 到 VCS (例如 Git) 中 。 


相关 内 容 : 第 1、2、3 章 。 


H.2 TDD 基 本 流程 


e WIA TDD (图 H-1)。 

。 遇 红 / 变 绿 / 重 构 。 

。 三 角 法 。 

。 便签 。 

。“ 三 则 重 构 ”原则 。 

e “从 一 个 可 运行 状态 到 另 一 个 可 运行 状态 ”。 
e “YAGNI” 原则。 

















unittest 不 错 ，py.test、nose 和 Green 也 有 一 定 优 势 。 


匡 架 中 运行 单元 测试 。 


o 
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编写 单元 测试 


编写 最 少量 的 代码 








B H-1: 包含 功能 测试 和 单元 测试 的 TDD 流程 


相关 内 容 : 第 4、5、7 章 。 


H.3 ”测试 不 止 要 在 开发 环境 中 运行 


尽早 进行 系统 测试 。 确 保 各 组 件 能 正常 协作 ， 包 括 Web 组 件 、 静 态 内 容 和 数据 库 。 
搭建 和 生产 环境 一 样 的 过 渡 环 境 ， 在 这 个 环境 中 运行 功能 测试 。 

自动 部 署 过 渡 环 境 和 生产 环境 : 

* PaaS 5 VPS; 

* Fabric; 

4 配置 管理 工具 (Chef, Puppet, Salt 和 Ansible) ; 

* Vagrant, 

彻底 弄 清楚 部 署 的 主要 步骤 数据库、 静态 文件 、 依 赖 、 如 何 定 制 设 定 ， 等 等 。 
尽早 搭建 CI 服务器， 运行 测试 不 能 只 靠 自律 。 


相关 内 容 : 第 9、11、24 章 ， 附 录 C。 
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H.4 通用 的 测试 最 佳 实 践 


。 每 个 测试 只 能 测试 一 件 事 。 
。 应 用 的 一 个 源码 文件 对 应 一 个 测试 文件 。 
。 不 管 函 数 和 类 多 么 简单 ， 都 至 少 要 编写 一 个 占 位 测试 。 

。“ 别 测试 常量 ”。 

。 尝试 测试 行为 ， 而 不 是 实现 方式 。 

。 不 能 顺 着 代码 的 逻辑 思考 ， 还 要 考虑 边缘 情况 和 有 错误 的 情况 。 
相关 内 容 : 884. 13, 14 章 。 


H.5 ”Selenium/ 功 能 测试 最 佳 实践 


。 相 较 隐 式 等 待 ， 多 使 用 显 式 等 待 和 交互 等 待 模式 。 

。 避免 编写 重复 的 测试 代码 一 一 可 以 在 基 类 中 定义 辅助 方法 ， 也 可 以 使 用 页 面 模式 。 

。 避免 重复 测试 同一 个 功能 。 如 果 测 试 中 有 耗 时 操作 (例如 登录 )， 可 以 找 一 种 方法 在 其 
他 测试 中 跳 过 这 一 步 (但 要 小 心 看 起 来 无 关 的 功能 相互 之 间 的 异常 交互 )。 

。 使 用 BDD 工具 ， 作 为 组 织 功能 测试 的 另 一 种 方式 。 


相关 内 容 : 第 21、24、25 章 。 


3 EE TT 3 sb \ 

H.6 ”由 外 而 内 ， 测 试 隔离 与 整合 测试 ， 模 拟 技术 
aE Y Sj ES AI E x 
。 确保 正确 性 ， 避 免 回 归 。 
。 有 利于 写 出 简洁 可 维护 的 代码 。 
。 实现 一 种 快速 高 效 的 工作 流程 。 
记 住 这 几 点 之 后 ， 再 看 不 同 的 测试 类 型 以 及 各 自 的 优 缺 点 。 
。 功能 测试 

4 从 用 户 的 角度 出 发 ， 最 大 程度 上 保证 应 用 可 以 正常 运行 。 

4 但 反馈 循环 用 时 长 。 

4 而 且 无 法 帮助 我 们 写 出 简洁 的 代码 。 
。 整合 测试 (依赖 于 ORM X Django WRAP HF) 
编写 速度 快 。 
易于 理解 。 
发 现任 何 集成 问题 都 会 提醒 你 。 
但 并 不 总 能 得 到 好 的 设计 (这 取决 于 你 自己 )。 
而 且 一 般 运 行 速度 比 隔离 测试 慢 。 
























































v 
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。 BRAA (使 用 驭 件 ) 

4 涉及 的 工作 量 最 大 。 

4 可 能 难以 阅读 和 理解 。 

4 但 这 种 测试 最 能 引导 你 实现 更 好 的 设计 。 

€ 而 且 运行 速度 最 快 。 
如 果 你 发 现 编写 测试 时 要 使 用 很 多 驭 件 ， 而 且 感 觉 很 痛苦 ， 那 么 记得 要 “倾听 测试 的 心 
声 ” 一 一 使 用 模拟 技术 写 出 的 丑陋 测试 试图 告诉 你 ， 代 码 可 以 简化 。 


相关 内 容 : 588 22, 23, 26 章 。 
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接 下 来 做 什么 





下 面 是 我 建议 你 接 下 来 可 以 研究 的 一 些 事情 ， 目 的 是 提升 测试 技能 ， 以 及 把 (写作 本 书 时 
的 ) 新 技术 应 用 到 Web 开发 中 。 


如 果 以 后 不 再 添加 附录 ， 我 希望 至 少 为 每 个 话题 写 一 篇 博客 文章 ， 也 编写 一 些 示 例 代 码 。 
所 以 请 读者 一 定 要 访问 http://www.obeythetestinggoat.com， 看 有 没有 更 新 。 


或 者 你 可 以 抢 在 我 前 面 ， 自 己 写 博客 文章 ， 记 录 你 尝试 其 中 任何 一 件 事 的 过 程 。 


我 很 乐意 回答 问题 以 及 为 这 些 话题 提供 提示 和 指引 ， 所 以 如 果 你 想 尝试 做 某 件 事 ， 但 卡 住 
了 ， 别 犹 浅 ， 联 系 我 吧 ， 电 子 邮 件 地 址 是 obeythetestinggoat@ gmail.com, 


E lI E E 
1.1 提醒 一 一 站 内 提醒 以 及 邮件 提醒 
如 果 有 人 把 清单 分 享 给 某 个 用 户 ， 能 提醒 这 个 用 户 就 好 了 。 
你 可 以 使 用 django-notifications， 在 用 户 下 次 刷新 页 面 时 显示 一 个 消息 。 在 这 个 功能 的 功能 
测试 中 需要 两 个 浏览 器 。 
或 者 ， 也 可 以 通过 电子 邮件 提醒 。 研 究 一 下 Django 对 测试 电子 邮件 的 支持 ， 然 后 你 会 发 
现 ， 测 试 的 过 程 需 要 发 送 真 的 电子 邮件 。 使 用 IMAPClient 库 可 以 从 网 页 邮件 测试 账户 中 
获取 真实 的 电子 邮件 。 


l2 $&HPostgres 


SQLite 对 小 型 数据 库 来 说 很 好 ， 但 如 果 有 不 止 一 个 Web 职 程 处 理 请 求 ， 那 它 就 无 法 胜任 
了 。 现 在 ，Postgres 是 大 家 最 喜欢 的 数据 库 ， 请 和 弄 清 怎么 安装 及 配置 Postgres。 
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你 要 找 一 个 文件 保存 本 地 、 过 渡 服务 器 和 生产 服务 器 中 Postgres 的 用 户 名 和 密码 。 因 为 出 
于 安全 的 考虑 ， 你 或 许 不 想 把 这 些 信息 放 入 代码 仓库 。 你 得 找到 一 种 方法 ， 让 部 署 脚本 把 
这 些 信息 传 入 命令 行 。 流 行 的 解决 方法 之 一 是 在 环境 变量 中 存储 这 些 信息 。 


你 可 以 实验 一 下 ， 看 单元 测试 在 SQLite 中 运行 比 在 Postgres 中 运行 快 多 少 。 为 此 ， 你 可 以 
在 本 地 设备 中 使 用 SQLite， 仅 做 测试 ， 但 在 CI 服务 器 中 使 用 Postgres。 


— hH 3 TI 和 V “一 :站 | >- 

1.3 ”在 不 同 的 浏览 器 中 运行 测试 

Selenium 支持 各 种 浏览 器 ， 包 括 Chrome 和 Internet Exploder。 尝 试 在 这 两 种 浏览 器 中 运 和 
功能 测试 组 件 ， 看 看 有 没有 什么 异常 表现 。 

你 还 应 该 试 试 无 界面 浏览 器 ， 比 如 PhantomJS 。 


根据 我 的 经 验 ， 在 不 同 的 浏览 器 中 测试 能 暴露 Selenium 测试 中 的 各 种 条 件 竞争 ， 而 且 可 能 
还 要 更 多 地 使 用 交互 等 待 模式 (尤其 是 在 PhantomJS 中 )。 


1 .4 400 和 500 测 试 


专业 的 网 站 需要 漂亮 的 错误 页 面 。400 页 面 的 测试 方法 很 简单 ， 但 如 果 想 测试 500 页 面 
或 许 得 编写 一 个 故意 抛 出 异常 的 视图 。 


l.5 Django 管理 后 台 
假设 有 个 用 户 发 邮件 声称 某 个 匿名 清单 是 他 的 。 为 此 ， 想 实现 一 种 手动 解决 方案 ， 由 网 站 
的 管理 员 在 管理 后 台中 手动 修改 记录 。 


弄 清楚 怎么 启用 和 使 用 管理 后 台 。 编 写 一 个 功能 测试 ， 首 先 由 一 个 未 登录 的 普通 用 户 创建 
一 个 清单 ， 然 后 管理 员 登 录 ， 进 入 管理 后 台 ， 把 这 个 清单 指派 给 这 个 用 户 ， 然 后 这 个 用 户 
即 可 在 “My Lists” 页 面 看 到 这 个 清单 。 


1.6 ”编写 一 些 安全 测试 

扩展 针对 登录 、“My Lists” 页 面 和 分 享 功能 的 测试 ， 看 看 需要 怎么 编写 测试 确保 用 户 只 能 
做 有 权限 做 的 事情 。 

1.7 测试 优雅 降级 

如 果 Persona 不 可 用 会 发 生 什么 ? 是 否 至 少 可 以 向 用 户 显 示 一 个 致 娄 消息 ? 


。 提示 : 模拟 Persona 服务 不 可 用 的 方式 之 一 是 修改 主机 文件 (路径 是 /etc/hosts 或 
c:\Windows\Sytem32\drivers\etc)。 记 得 在 测试 的 tearDown 方法 中 撤销 改动 。 
。 要 同时 考虑 服务 器 端 和 客户 端 。 
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l8 ”缓存 和 性 能 测试 


弄 清 楚 如 何 安装 和 配置 nemcached， 以 及 如 何 使 用 Apache 的 ab 工具 运行 性 能 测试 。 在 有 
缓存 和 没有 缓存 两 种 情况 下 ， 网 站 的 性 能 如 何 ? 你 能 否 编写 一 个 自动 化 测试 ， 如 果 检 测 到 
没 启用 缓存 就 失败 ?应 该 怎么 处 理 可 怕 的 缓存 失效 问题 ?测试 能 否 帮 你 确认 缓存 失效 逻辑 
是 可 靠 的 ? 


I.9 JavaScript MVC 框 架 


现今 ， 在 客户 端 实现 “模型 - 视图 -控制 器 ”(Model-View-Controller，MVC) 模式 
的 JavaScript 库 比 较 流 行 。 这 种 库 喜欢 使 用 待 办 事项 清单 应 用 做 演示 ， 所 以 把 这 个 网 
站 改写 成 单 页 网 站 应 该 很 容易 。 在 单 页 网 站 中 ,添加 清单 的 所 有 操作 都 由 JavaScript 
代码 完成 。 

选 一 个 框架 ，Backbonejs 或 Angularjs， 探 究 一 下 怎么 实现 。 在 各 种 框架 中 编写 单元 测试 
都 有 各 自 的 方式 。 学 习 一 种 方式 ， 一 直 使 用 下 去 ， 看 你 是 否 喜欢 。 


















































1.10 “异步 和 websocket 


假设 两 个 用 户 同 时 编辑 同一 个 清单 ， 如 果 能 看 到 实时 更 新 ， 即 一 个 用 户 添 加 待 办 事项 之 
后 ， 另 一 个 用 户 立 即 就 能 看 到 ， 是 不 是 很 棒 ? 这 种 功能 可 以 通过 使 用 websocket 在 客户 端 
和 服务 器 之 间 建 立 持久 连接 实现 。 

研究 一 种 Python 异步 Web 服务 器 ，Tornado、gevent 或 Twisted， 看 你 能 否 用 它 实 现 动 态 
提醒 。 

测试 时 需要 两 个 浏览 器 实例 (就 像 在 分 享 功 能 的 测试 中 一 样 )， 检 查 不 刷新 页 面 的 情况 下 ， 
操作 提醒 是 否 会 出 现在 另 一 个 浏览 器 实例 中 。 


l.11. 换 用 py.test 


使 用 py.test 编写 单元 测试 不 用 写 那 么 多 样板 代码 。 尝 试 使 用 py.test 改写 一 些 单元 测试 。 或 
许 需 要 使 用 插件 才能 和 Django 无 颖 配合 。 















































1.12 ” 试 试 coverage.py 

Ned Batchelder 开发 的 coverage.py 能 告诉 你 测试 的 覆盖 度 如 何 ， 即 测试 覆盖 百 分 之 多 少 的 
人 代码。 目前， 我 们 使 用 的 是 严格 的 TDD， 因 此 理论 上 覆盖 度 应 该 始终 为 100%， 不 过 再 确 
认 一 下 更 好 。 而 且 对 于 没有 从 头 开 始 编写 测试 的 项 目 来 说 ， 这 个 工具 是 十 分 有 用 的 。 
1.13 ”客户 端 加 密 

这 个 比较 有 趣 : 如 果 用 户 太 偏执 ， 不 再 相信 NSA (美国 国家 安全 局 )， 觉 得 把 清单 放 在 去 
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端 不 安全 该 怎么 办 ?你 能 不 能 使 用 JavaScript 构建 一 个 加 密 系统 ， 在 待 办 事项 发 给 服务 器 
之 前 ， 让 用 户 输 入 密码 ， 加 密 自己 的 清单 。 


针对 这 种 功能 的 测试 ， 可 以 这 么 写 : 管理 员 登 录 Django 管理 后 台 ， 查 看 用 户 的 清单 ， 确 
认 清 单 中 的 待 办 事项 在 数据 库 中 是 否 使 用 密 文 存储 。 


1.14 ”你 的 建议 


你 觉得 我 应 该 在 这 个 附录 中 写 些 什么 ? 提 些 建议 吧 | 

































































450 | 附录 1 


Py SR J 


示例 源码 





本 书 的 所 有 示例 代码 都 在 我 的 一 个 GitHub 仓库 中 (https://github.com/hjwp/book-example/) 。 
如 果 你 想 对 比 你 我 的 代码 ， 可 以 看 一 下 那个 仓库 。 


每 一 章 都 有 自己 的 分 支 ， 分 支 名 与 章 序 一 样 ， 例 如 chapter_01。 
注意 ， 各 分 支 包 含 对 应 那 一 章 的 所 有 提交 ， 因 此 有 是 那 一 章 结束 时 最 终 得 到 的 代码 。 


此 外 ， 各 章 分 别 的 代码 示例 也 可 至 图 灵 社 区 下 载 ， 详 情 请 见 http//www.ituring.com.cn/2052 
“ 随 书 下 载 ”处 。 
































J.1 使 用 Git 检 查 自己 的 进度 


如 果 你 想 锻炼 自己 的 Git 技能 ， 可 以 把 我 的 仓库 添加 为 远程 仓库 : 


git remote add harry https://github.com/hjwp/book-example.git 
git fetch harry 


若 想 查 看 第 4 章 结束 后 你 我 的 代码 有 什么 差异 ， 可 以 这 样 做 : 

git diff harry/chapter philosophy and refactoring 
Git 能 处 理 多 个 远程 仓库 ， 即 便 你 已 经 把 自己 的 代码 推送 到 GitHub 或 Bitbucket， 依 然 可 以 
这 么 做 。 


注意 ， 类 中 方法 的 顺序 在 你 我 的 代码 中 可 能 不 完全 相同 ， 这 可 能 导致 差异 不 好 读 。 
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J.2 下载 各 章 代 码 的 ZIP 文 件 


如 果 鉴 于 某 些 原因 ， 阅 读 某 一 章 时 你 想 “ 从 头 做 起 ”， 或 者 跳 过 某 一 章 ，' 抑或 你 就 是 不 想 使 
用 Git， 可 以 下 载 代码 的 ZIP 文件 ， 详 情 请 见 htp:/www.ituring.com.cn/2052“ 随 书 下 载 ”处 。 


J.3 不 要 完全 依赖 我 的 代码 


除非 真 的 卡 住 ， 不 知道 怎么 做 了 ， 否 则 不 要 偷 看 答案 。 前 面 说 过 ， 自 己 动手 调试 错误 能 学 
到 很 多 ， 而 且 当 你 自己 开发 时 ， 可 没有 我 的 仓库 供 你 对 比 ， 也 没有 现成 的 答案 供 你 参考 。 






































注 1; 我 不 建议 你 号 着 读 。 我 在 撰写 时 并 没有 考虑 各 章 的 独立 性 ， 后 面 的 章节 要 依赖 前 面 的 章节 ， 跳 着 读 可 
能 会 更 让 你 不 明 所 以 …… 
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作者 简介 


Harry 的 童年 很 美好 ， 他 在 Thomson T-07 〈 当 时 在 法 国 很 流行 ， 按 键 后 会 发 出 “ 踊 喉 ” 
È) 这 种 8 位 电脑 上 摆弄 BASIC， 长 大 后 做 了 几 年 经 管 顾问 ， 但 完全 不 快乐 。 而 后 他 发 
现 了 自己 真正 的 极 客 潜质 ， 又 很 幸运 地 遇 到 了 一 些 极限 编程 狂热 者 ， 参 与 开发 了 电子 制 
表 软 件 的 先驱 Resolver One， 不 过 很 可 惜 ， 这 个 软件 现在 已 经 退出 历史 王 台 。 他 目前 在 
PythonAnywhere LLP 公司 工作 ， 而 且 在 各 种 演讲 、 研 讨 会 和 开发 者 大 会 上 积极 推广 TDD. 


封面 介绍 


本 书 封面 上 的 动物 是 开 司 米 山 羊 。 虽 然 所 有 山羊 都 长 有 开 司 米 ， 但 人 类 只 选择 培育 这 种 山 
羊 ， 产 出 能 满足 商用 数量 的 开 司 米 ， 所 以 一 般 只 有 这 种 山羊 叫 “ 开 司 米 山羊 "。 因 此 ， 开 
司 米 山羊 是 一 种 驯养 的 家 山羊 。 

开 司 米 山羊 长 有 一 层 异 常 柔 软 顺 滑 的 内 层 线 毛 ， 外 敌 一 层 粗糙 的 羊毛 一 一 这 就 是 山羊 的 两 
层 羊 毛 。 开 司 米 在 冬季 长 成 ， 目 的 是 补充 外 层 羊毛 GIE AE) 的 御寒 能 力 。 开 
司 米 中 毛发 的 卷曲 量 决定 了 它 的 重量 和 保暖 性 能 。 

“ 开 司 米 ” 这 个 名 字 出 自 印 度 次 大 陆 上 的 克什米尔 山谷 地 区 。 在 这 一 地 区 ， 纺 织品 已 经 出 现 
几 午 年 了 。 现 在 的 克什米尔 地 区 ， 开 司 米 山 羊 数量 不 断 减少 ， 所 以 不 再 出 口 开 司 米 纤维 。 
现在 ， 大 多 数 开 司 米 毛 织品 都 出 自 阿 富 汗 、 伊 朗 、 蒙 古国 和 印度 ， 以 及 占 主导 地 位 的 中 国 。 


开 司 米 山 羊 的 羊毛 有 多 种 颜色 和 颜色 搭配 。 雄 性 和 峻 性 都 长 有 特 角 ， 夏 季 可 用 于 散热 ， 干 
农活 时 主人 也 能 用 它们 更 好 地 控制 其 他 山羊 。 


封面 图 片 出 自 Wood 的 Animate Creation — 35, 
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回复 “Python” 查 看 相关 书 单 


e 
微 博 连接 
关注 @ 图 灵 教 育 每 日 分 享 |T 好 书 


e 


QQ 连接 


图 灵 读 者 官方 群 I: 218139230 
灵 读 者 官方 群 [I[: 164939616 











^] 





图 灵 社 区 


iTuring.cn 


在 线 出 版 , 电子 书 ,《 码 农 》 杂 志 , 图 灵 访谈 





O'REILLY’ 





Python 测试 驱动 开发 


本 书 手 把 手 教 你 从 头 开 发 一 个 真正 的 Web 应 用 ， 演 示 使 用 Python 做 测试 
驱动 开发 (TDD) 的 优势 。 你 将 学 会 如 何在 开发 应 用 的 每 一 个 组 成 部 分 
之 前 编写 和 运行 测试 ， 然 后 再 编写 最 少量 的 代码 让 测试 通过 ， 最 终 得 到 
简洁 可 用 的 代码 。 此 外 ， 你 还 会 了 解 Django、Selenium、Git、jQuery 和 
Mock 的 基础 知识 ， 以 及 其 他 目前 流行 的 Web 开 发 技术 。 


E 深入 分 析 TDD 流 程 ， 包 括 “ 单 元 测试 /编写 代码 ”循环 和 重 构 


m 使 用 单元 测试 检查 类 和 函数 ， 使 用 功能 测试 检查 浏览 器 中 的 用 户 
交互 


m 学 习 何 时 、 如 何 使 用 驭 件 ， 以 及 隔离 测试 和 整合 测试 的 优 缺 点 
m 在 过 渡 服 务 器 中 测试 和 自动 部 署 

m 测试 网 站 中 集成 的 第 三 方 插件 

m 使 用 持续 集成 环境 自动 运行 测试 

m 使 用 TDD 构 建 一 个 具有 Ajax 前 端 界 面 的 REST API 





哈 利 .JW. 帕 西 瓦尔 (Harry J.W. Perciva)，TDD 积 极 践 行者 ， 曾 参与 开发 
电子 制作 表 软 件 先驱 Resolver One; 目前 就 职 于 PythonAnywhere 公 司 ， 
经 常 受 邀 参加 TDD 和 Python 开发 主题 演讲 、 研 讨 会 和 开发 者 大 会 ， 取 
得 了 利物浦 大 学 计算 机 科学 硕士 学 位 和 剑桥 大 学 哲学 硕士 学 位 。 


封面 设计 : Karen Montgomery 张 健 


图 灵 社 区 : iTuring.cn 
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“要 使 开发 者 保持 头脑 清醒 ， 测 试 


可 谓 至 关 重 要 。 哈 利 完 成 了 一 项 

不 可 思议 的 工作 ， 他 不 仅 吸 引 了 

我 们 对 测试 的 关注 ， 而 且 还 探索 
了 切实 可 行 的 测试 实践 方案 。” 

— —Michael Foord 

Python 核心 开发 者 、 

unittest 维 护 者 


“这 本 书 远 不 只 是 介绍 了 测试 驱动 


开发 ， 它 还 是 一 套 完整 的 最 佳 实 
践 速成 课程 ， 完 整 介绍 了 如 何 使 
用 Python 开 发 现代 Web 应 用 。” 
Kenneth Reitz 
Python 软件 基金 会 特别 会 员 





“真希 望 在 我 们 学 习 Django 时 ， 


就 能 有 了 哈 利 的 这 本 书 。 它 对 
Django 和 多 种 测试 实践 进行 了 
精彩 讲解 ， 难 度 恰当 且 不 乏 挑 


一 一 Daniel Greenfeld 和 Audrey Roy 


Two Scoops of Django 作者 


ISBN 978-7-115-48557-1 
9 TII > 
ISBN 978-7-115-48557-1 
定价 : 119.00 元 





看 完了 


如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编辑 
或 作 译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨 论 。 


如 果 是 有 关 电 子 书 的 建议 或 问题 ， 请 联系 专用 客服 邮箱 : 


ebook@turingbook.com。 
在 这 可 以 找到 我 们 : 


微 博 @ 图 灵 教育 : 好 书 、 活 动 每 日 播报 

微 博 @ 图 灵 社 区 : 电子 书 和 好 文章 的 消息 

微 博 @ 图 灵 新 知 : 图 灵 教 育 的 科普 小 组 

微 信 图 灵 访 谈 : ituring_interview， 讲 述 码 农 精彩 人 生 
微 信 图 灵 教 育 : turingbooks 


